Apptimize

Overview

The Apptimize integration allows users to export Mixpanel cohorts into Apptimize groups, allowing you to target specific users using Apptimize.

Mixpanel cohorts can be exported to Apptimize one time, or sync and update every 15 minutes.

Permissions

You must be a Mixpanel project admin to enable the Apptimize integration.

Enable the Integration

Follow these steps to enable the integration with Apptimize:

1. Select Integrations under the Data Management tab in the top navigation bar of Mixpanel.

2. From the Integrations page, select the Apptimize dropdown, and select Connect.

3. You will need to provide an Apptimize Token (generated from the Apptimize dashboard) to authorize the connection. To generate an Apptimize token, go to the Tokens page on Apptimize Dashboard and click “New Token”. Give the token a memorable name and click Generate.

4. Use the Apptimize token to authorize the Mixpanel integration.

Matching Users between Apptimize and Mixpanel

Warning: Projects using the simplified ID merge system must have the $user_id in Mixpanel match the user identifier in the partner service. Using any alternative partner properties to match users between tools may result in partner events not being attributed to the correct user in Mixpanel. Any partner properties mentioned in the below section are primarly applicable to projects on the original ID merge system.

Mixpanel only exports identified user profiles (users with at least 1 set profile properties) to match to Apptimize - users without user profiles (i.e. anonymous users) will not export.

The exported users are properly mapped in Apptimize automatically by the integration through the setting of $apptimize_user_id user property. This property is set automatically when both the Apptimize and Mixpanel SDKs are installed on the client.

In addition, when our ingestion service detects calls setting this user property, Mixpanel will also auto-alias the value of $apptimize_user_id to the user's distinct_id. This ensures that experiment data passed from Apptimize to Mixpanel still attributes to the correct user.

Note: Mixpanel users can be associated with Apptimize users manually by setting the $apptimize_user_id in Mixpanel with the Apptimize.getPartnerID method available in the Apptimize SDK. Do this if ThirdPartyImporting is disabled in Apptimize or when using the Mixpanel Swift SDK, which does not support ThirdPartyImporting. It is important to note that the Apptimize.getParterID will return a modified variation of the customer user ID by prefixing "i_" or "a_" to represent if the ID is identified or anonymous, and will allow Apptimize to properly match users from Mixpanel cohorts.

Export a Cohort

To export a cohort to Apptimize, navigate to Cohorts by clicking in the Data Management tab and select Cohorts.

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

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

Sync Types

This integration supports two types of exports: one-time export and recurring syncs. When you generate a one-time export or recurring sync, it overwrites the previous export with an updated export that reflects users who qualify for the cohort at the time of export.

One-Time Export

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

Recurring Sync

In recurring sync, Mixpanel initiates sync between a cohort and Apptimize every 15 minutes. The exported cohort will be updated every fifteen minutes to reflect the most recent list of users in a cohort.

Observe the Audience in Apptimize

Once the export completes, you will see your cohorts appear in your Apptimize Groups page.