MoEngage Integration

Export Mixpanel cohorts to MoEngage to create custom segments that you can apply in your MoEngage campaigns. Manage the MoEngage integration from the Mixpanel integrations page.

This integration is currently in closed beta - please reach out to your account team or the Community team to ask about access.

MoEngage also supports an integration to send messaging interactions to Mixpanel - for more details, see MoEngage's Mixpanel integration.

Permissions

You must be a Mixpanel project admin to enable the MoEngage integration. Read more about project roles and permissions here.

Enable the Integration

To enable the integration, select Integrations under the Data Management tab in the top navigation bar:

From the Integrations page, select the MoEngage dropdown, and select Connect.

The connection uses a Basic Authorization Username/Password system. You will need to provide two credentials to authorize the connection:

• Username: MoEngage App ID
• Password: MoEngage API Key

You will additionally provide one credential to authorize the cohort exports:

• MOE-APPKEY: MoEngage App ID

You can find these values in your MoEngage settings page - note that MoEngage App ID is used in both the Username and MOE-APPKEY fields.

The MoEngage integration will show a "Connected" tag in the UI once the connection succeeds.

Matching Users between MoEngage and Mixpanel

If you use a different system of user identifiers for Mixpanel's distinct_id as compared to MoEngae's user_id, the user's Mixpanel profile must contain a user property, "$moengage_user_id", whose value is a string representing that person's user_id in MoEngage. Use this joining key if your user identifiers in Mixpanel are different from the identifiers used in MoEngage.

In addition, Mixpanel will also alias the value of "$moengage_user_id" to the user's distinct_id when setting that user property. This ensures that messaging data passed from MoEngage to Mixpanel still attributes to the correct user.

If you use the same system of user identifiers in both tools, you do not have to declare "$moengage_user_id" - the Mixpanel user profile will still be sent and processed by MoEngage, and instead use the Mixpanel distinct_id to map a user to its MoEngage equivalent.

Export a Cohort

You can export a cohort to Iterable from the Cohorts report. Navigate to Cohorts by clicking Cohorts under Users in the navigation bar.

Select the cohort that you want to export. Click on the three-dot icon on the right side of the cohort.

Click Export to MoEngage. Select either one-time sync or dynamic sync. Click Start Sync.

Sync Types

This integration supports two types of exports: one-time export and dynamic sync.

One-Time Export

In a one-time export, Mixpanel sends MoEngage a static export of users who currently qualify for the cohort. The cohort data will not be updated in MoEngage after a one-time export.

Dynamic Sync

In dynamic sync, Mixpanel initiates sync between a cohort and MoEngage every two hours. The exported cohort will be updated every two hours to reflect the most recent list of users in a cohort.

When you generate a one-time export or dynamic sync, it overwrites the previous export with an updated export that reflects users who qualify for the cohort at the time of export.

Select the Custom Segment in MoEngage

Once the export completes, you will see a custom segment reflecting the set of users from your Mixpanel cohort (e.g. "Power Users"):

MoEngage events into Mixpanel

MoEngage offers the ability to forward campaign interaction events to Mixpanel. For more detail, please refer to MoEngage's integration guide.