Introduction

Mixpanel makes analytics self-serve for your product teams and enables everyone to answer questions around user conversion, retention, and activation.

Scope

The MoEngage and Mixpanel integration allow you to import Mixpanel Cohorts into MoEngage to create segments that can be used to target users in future campaigns. You can also leverage MoEngage streams to export your campaign events to Mixpanel to drive deeper analytics into conversions, retention, and product usage.

Benefits and Use Cases

Analyze your users in Mixpanel and engage with them using MoEngage.

The following use-cases provide integration value addition to your analytics + user engagement activities:

E-commerce

Understand the seasonal changes in purchase trends that are happening and send rich push notifications to such users via MoEngage. For example, target the cohort of users who purchase high-value items during summers and send rich push notifications with similar recommended items.

Travel

You can create a cohort in Mixpanel of millennial users who are also premium users of your app and send them popular and unique holiday destination recommendations via MoEngage emails.

E-learning

Understand where your users are dropping off while watching a video series on your platform and bring them back with engaging campaigns! Through insights into user behavior, you are armed with a holistic picture of exactly what actions can trigger a user to return to the app.

Integration 

The Mixpanel Integration with MoEngage consists of two parts:

Cohort Sync from Mixpanel to MoEngage:

Mixpanel to MoEngage integration allows you to export cohorts in Mixpanel to MoEngage and send personalized campaigns to all the users under this cohort from MoEngage. 

Streaming MoEngage Events to Mixpanel

MoEngage to Mixpanel integration allows you to export the campaign interaction events generated after your users engage with the MoEngage campaigns to Mixpanel.

Setting up MoEngage integration on Mixpanel

To setup MoEngage Integration on Mixpanel, follow the below steps:

1.  Log in to Mixpanel and navigate to Data Management -> Integrations
   
2. On the Integrations page, search MoEngage and click on the CONNECT button. You will see a pop-up to enter the MoEngage credentials as described:
   
3. Fill the following fields from the MoEngage dashboard by navigating to Settings > API Settings:
   

   Field	Action
   USERNAME	Type or copy and paste the Data API ID.  The Data API ID and the Workspace ID of your MoEngage account are the same.
   PASSWORD	Type or copy and paste the Data API Key.  The Data API key of your MoEngage account is available in the following navigations in the revamped and old UIs: Revamped UI:  Settings -> App Settings -> APIs -> API Keys -> Data Old UI: You can find this by navigating to Settings -> App Settings -> APIs -> Data API Settings.
   MOE-APPKEY	Type or copy and paste the Workspace ID. The Workspace ID of your MoEngage account is available in the following navigations in the revamped and old UIs: Revamped UI:  Settings -> Account -> APIs -> Workspace ID. Old UI: You can find this by navigating to Settings -> App Settings -> APIs -> Data API Settings.
   MOENGAGE DATACENTER	MoEngage data center that you signed with you on MoEngage. For more information about the data center that you signed up with, please refer to Data centers in MoEngage.

   
4. Click save on continue to connect MoEngage as an integration.

For more information, refer to Mixpanel - MoEngage Integration.

Exporting Cohorts from Mixpanel to MoEngage

To export specific cohorts from Mixpanel to MoEngage, follow these steps:

1. Navigate to the cohorts page on Mixpanel dashboard
   
2. Click on the three dots menu on the right-hand side of any cohort and use the Export to option to export the particular cohort to MoEngage.
   
   A pop-up is displayed.
3. In the Export to MoEngage pop-up, select one of the following:
   
   

   Selection	Description
   One-time export	Only export the users under the cohort to MoEngage once and the cohort will not sync thereafter.
   Dynamic sync	Ensure that the updated information of the cohorts like the new users who qualify for this cohort and the existing users who are removed from the cohort are sent to MoEngage every 15 minutes.

4. Click Begin Sync to export.
5. Check the export status after you export the cohort as described.
   

Using Cohorts in MoEngage Campaigns

Once an export is complete, you will be able to see the cohort as a custom segment in MoEngage as in the following image:

The custom segment can be used in any MoEngage campaigns to send personalized messages to the users under this segment.

User Mapping between Mixpanel and MoEngage

When you are exporting cohorts from Mixpanel to MoEngage, all users in your Mixpanel cohort will be attempted to be mapped with unique user profiles in MoEngage. We will be relying on a unique user identifier that will be present across Mixpanel and MoEngage users for mapping. This identifier will also be used when sending campaign events from MoEngage to Mixpanel.

You need to ensure that you are adding an alias for your Mixpanel distinct_id and that the same identifier is used as ID (unique user id) in MoEngage.

For more information on tracking unique user id in MoEngage, refer to 

• Android

• iOS

Exporting Campaign Data from MoEngage to MixPanel

On your MoEngage Dashboard, go to the App Marketplace and search for MixPanel.

1. Click on "+ Add Integration" to add a new integration.
2. Fill out the form.
3. Mixpanel project token - This is available on your Mixpanel Dashboard -> Settings -> Overview -> Access Keys -> Project Token as shown below -
   
4. Select the events you want to forward. By default, MoEngage will be sending the data points mentioned in the next section to Mixpanel.
5. Click on "Connect" to save the integration.

All the events sent by MoEngage are displayed in Mixpanel by filtering basis $source = MOENGAGE. These events are sent to Mixpanel in near real-time and use the Mixpanel distinct_id for mapping user profiles between MoEngage and Mixpanel.

Export Data

The following data points are by default sent to Mixpanel:

Troubleshooting

The user count for the segment is 0?

Please check if the custom segment name is "All users". All users is reserved for MoEngage and cannot be used as the custom segment name.

The segment is not showing up on MoEngage dashboard? 

Please check archived segments on MoEngage. You can check your archived segments here. Please unarchive your segment and then retry.