Integrate OneSignal with Mixpanel 2025

How to Integrate OneSignal with Mixpanel: A Comprehensive Guide

Integrate OneSignal with Mixpanel

The integration between Mixpanel and OneSignal combines the power of analytics with personalized messaging, allowing businesses to optimize engagement strategies through data-driven insights. This guide provides a step-by-step walkthrough to set up and utilize this integration effectively.

Key Benefits of the Integration

• Personalized Messaging: Deliver tailored messages with OneSignal, triggered by user behaviors such as entering or exiting Mixpanel cohorts.
• Real-Time Insights: Get a complete picture of user engagement by merging Mixpanel’s in-product user activity data with OneSignal’s messaging metrics.
• Data-Driven Campaigns: Re-engage users by leveraging Mixpanel’s product-level insights and OneSignal’s targeted communication tools.

Prerequisites for Integration

Before getting started, ensure you have:

• An active Mixpanel account.
• An upgraded OneSignal account.
• The OneSignal Mobile SDK or Web SDK for data transfer (not required for email/SMS-only integrations).
• A OneSignal External ID set to match a Mixpanel user property.

Step-by-Step Setup

Step 1: Enable Integration in OneSignal

Integrate OneSignal with Mixpanel

1. Log in to OneSignal.
2. Navigate to Settings > Integrations > Mixpanel.
3. Click Activate to turn on the integration.

Step 2: Add Mixpanel Token in OneSignal

Integrate OneSignal with Mixpanel

1. In Mixpanel, find your Project Token under Project Settings > Access Keys.
2. Copy and paste the token into the OneSignal dashboard.
3. Configure which events from OneSignal you want to sync back to Mixpanel.
4. Check your Data Residency setting in Mixpanel:
   • If listed as "US," leave the Send events exclusively to Mixpanel EU servers box unchecked.
   • If listed as "EU," check the box.

Step 3: Connect OneSignal to Mixpanel

Integrate OneSignal with Mixpanel

1. Go to the Mixpanel Integrations dashboard.
2. Select OneSignal and press Connect.
3. Copy the "App ID" and "REST API Key" from OneSignal Settings > Keys & IDs.
4. Paste these values into Mixpanel to complete the connection.

Integrate OneSignal with Mixpanel

User ID Property

Ensure that OneSignal’s External ID matches a user property in Mixpanel, such as "User ID" or

Integrate OneSignal with Mixpanel

$distinct_id. This synchronization allows seamless communication across platforms.

Advanced Configurations

Step 4: Sync External IDs

• OneSignal's External ID must align with a Mixpanel user property to support multi-channel messaging (Push, Email, In-App, SMS).
• Add user email addresses and phone numbers to OneSignal for targeted messages.

Step 5: Migrate Current Mixpanel Subscriptions (Optional)

• Use CSV imports or the OneSignal API to add email addresses and phone numbers.
• Ensure that the imported data includes the external_id field, matching Mixpanel’s "User ID."

Step 6: Export Mixpanel Cohorts to OneSignal

Integrate OneSignal with Mixpanel

1. Go to Mixpanel Users > Cohorts.
2. Select the desired cohort and choose Export to > OneSignal.

Integrate OneSignal with Mixpanel

1. Select:
• One-Time Export for static data.

Integrate OneSignal with Mixpanel

• Dynamic Sync for updates every 15 minutes.
1. Exported cohorts will appear as new segments in OneSignal under Audience > Segments.

Using the Integration

Sending Messages with OneSignal

You can now send personalized messages using the following channels:

• Push Notifications
• In-App Messages
• Emails
• SMS Campaigns

Explore message personalization options with synced user data such as $first_name and $last_name.

Step 7: Track Message Engagement in Mixpanel

OneSignal with Mixpanel 

Message events from OneSignal, such as Message Sent and App Opened, appear in Mixpanel’s User Activity Feed. Detailed properties for each event provide insights into user interactions and campaign performance.

Cohort Events and Properties in OneSignal-Mixpanel Integration

Integrating OneSignal with Mixpanel allows businesses to track and analyze messaging events seamlessly. This guide explains the cohort events and their properties when syncing OneSignal data to Mixpanel.

Message Event Kinds and Descriptions

OneSignal sends various message events to Mixpanel, which are categorized based on the type of message and action taken by the user. Below is a detailed table outlining the events and their corresponding descriptions:

Message Event Kind (OneSignal)	Message Event Name (Mixpanel)	Event Description
Push Sent	Message Sent	Push notification successfully sent
Push Received	Message Received	Push notification successfully received
Push Clicked	App Opened from Push	Push notification touched on device
In-App Message Displayed	App Opened from Push	In-App Message successfully displayed on device
In-App Message Clicked	Message Opened	In-App Message clicked on device
Email Sent	Message Sent	Email successfully sent
Email Opened	Message Opened	Email opened by recipient

Event Properties

In addition to events, OneSignal sends specific properties associated with each event to Mixpanel. These properties provide detailed insights into user actions and message performance. The table below lists the available event properties:

Property Name	Description
Distinct ID	The external_id associated with the message
Message ID	The identifier of the discrete message
Message Name	The message name
Message Title	The message title
Message Contents	The message contents
message_type	The type of message sent: push, in-app, email, SMS
device_type	The device type that received the message
language	The two-character language code of the device

By understanding these event kinds and properties, you can better analyze and optimize your campaigns through the OneSignal-Mixpanel integration. Make data-driven decisions to enhance user engagement across various messaging channels.

Example Cohorts for OneSignal and Mixpanel Integration

1. Did Not Click a Push or In-App Message

This cohort identifies users who may not have interacted with your push or in-app message, allowing you to engage them through alternative channels like email or SMS.

Cohort Criteria

Users who received a message:	Message Sent > 1 time in the Last Day where Message Type = Push
AND	Users who did not interact: Did Not have the App Opened from Push in the Last Day

2. Were Shown a Specific Message in the Past Day

This cohort focuses on users who were shown a particular in-app message recently, allowing further targeted engagement.

Cohort Criteria

Users who were shown the message:	Message Sent ≥ 1 time in the Last 7 Days where Message Type = In-App and Message = [Name of the Message]
Message Derived from:	Push Notification Title, In-App Message Name

OneSignal with Mixpanel 2025

Use Cases for These Cohorts

• Re-engage inactive users: Send targeted campaigns to users who didn’t interact with your initial message.
• Personalize follow-ups: Leverage insights from users who viewed specific messages to tailor subsequent communication.
• Optimize messaging channels: Identify the best-performing channels by analyzing interaction rates across cohorts.