Urban Airship: Set Up Guide

The Urban Airship integration with Mixpanel allows users to export Mixpanel cohorts into Urban Airship. This updates the Mixpanel Tag Group in Urban Airship, allowing you to target specific Mixpanel cohorts using Urban Airship. Mixpanel cohorts can be exported to the Urban Airship Tag Group once, or the cohort data can sync dynamically and update the Tag Group every two hours. 

How does Mixpanel export data to Urban Airship?

For one-time exports: Mixpanel will send a static export of users who currently qualify for the cohort. This is exported to Urban Airship as a Tag Group that allows you to create an audience to target users. You will be able to name the Tag Group that appears in Urban Airship. These names will only be added to the Tag Group with the Group Key called “mixpanel” (Group Keys are case sensitive).

It is not recommended to use the same tag name for two static exports, as users who qualified at each time of export will be included in the tag within Urban Airship.

For dynamically syncing exports: Every 2 hours, Mixpanel will initiate a sync between the Mixpanel cohort and the Urban Airship tag. At the time of the sync, Mixpanel will remove or add the tag for all users based on cohort criteria. Users can move into and out of the cohort depending on if they meet the cohort criteria. This will be reflected in Urban Airship on a bi-hourly basis. Note that these tags only apply to the “mixpanel” Tag Group Key, which must be created within Urban Airship.

How are users matched between Urban Airship and Mixpanel?

Users are matched between Urban Airship and Mixpanel using the Urban Airship channel id, which is automatically set by the Mixpanel SDK if the Urban Airship SDK is present in Mixpanel. Within Mixpanel, the id is saved as a user profile property:

  • iOS: $ios_urban_airship_channel_id
  • Android: $android_urban_airship_channel_id

Setting up the Urban Airship Integration 

In order to integrate Urban Airship with Mixpanel, you will first need to install both the Urban Airship SDK and Mixpanel SDK in your application. Once you have done so, follow these steps:

  1. Go to the Urban Airship Integrations User Interface and enter the Urban Airship Master Secret and Key, which allows Mixpanel to send data to the correct Urban Airship project.

  2. Create a cohort in Mixpanel.

  3. Create a Mixpanel Tag Group within Urban AirshipFor this Integration, we require that you create a Tag Group Key called "mixpanel". Note that Tag Group Keys are case sensitive.

  4. Export the Cohort from Mixpanel, at which time Mixpanel will wait for a callback to ensure that the request to Urban Airship was received.

    • A one-time export will add the new Urban Airship tag to all users in the Mixpanel cohort at the time of the export. The new tag will be visible in Urban Airship. 
    • A dynamic sync will add or remove a tag for users in the cohort every 2 hours until the sync is disconnected. This means that every two hours, the tag in Urban Airship will update to reflect the current status of the Mixpanel cohort.

Sending Mixpanel Cohorts to Urban Airship

Exporting data to Urban Airship is done from the Mixpanel Cohort Manager. From the Cohort Manager: 

1. Click Export to Urban Airship.


2. Enter the Urban Airship Tag under which the export should be saved. Click Save.


3. The tag will now be available for targeting within Urban Airship.


Why am I unable to configure our Urban Airship connection?

You must be an Admin within the Mixpanel project to configure the Urban Airship connection.

Why does my Mixpanel Cohort display more users than in Urban Airship?

In order for a user to be exported to Urban Airship, the user must have the necessary property set on the user profile. These properties are $ios_urban_airship_channel_id or $android_urban_channel_id.

Is there a limitation to the number of profiles that can be exported to Urban Airship?

15 million profiles is the maximum number of profiles that can be exported to Urban Airship.

Did this answer your question?



Article is closed for comments.