Braze: Set Up Guide

The Mixpanel Braze integration exports Mixpanel Cohorts into Braze. This allows you to send Braze campaign messages to targeted cohorts that are created in Mixpanel. You can also send your Braze events into Mixpanel to apply deeper analysis. 

Export Types

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

One-Time Export

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

Dynamic Sync

In a dynamic sync, Mixpanel initiates a sync between a cohort and Braze 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 a dynamic sync, it overwrites the previous export with an updated export that reflects users who qualify for the cohort at the time of export.

Getting Started

Install the Mixpanel and Braze SDKs in order to build the integration.

Braze SDK: Android | Swift | Objective-C

Mixpanel SDK: Android | Swift | Objective-C

Note that the integration requires the following Mixpanel SDK versions: Android v5.4.1+, Swift v2.4.3+, and Objective-C v3.3.3+.

Set Up the Braze Integration

Integrating Mixpanel and Braze requires obtaining the required credentials from Braze, and then configuring the integration from a Mixpanel project.

Required Credentials

In order to set up the integration, you must use a Data Import Key and a Braze Instance URL to connect a Mixpanel instance with a Braze instance.

A Braze project stores the Data Import Key and Braze Instance URL. You can find these two values in from within Braze. Use the Braze documentation to learn how to obtain the Key and URL

Set Up the Integration

Enter the Mixpanel project where the integration is to be performed, then:

1. Click Data Management at the top of Mixpanel and select Integrations.


2. Select the Braze integration tab. Click Connect.


3. Enter the Data Import Key and select a Braze Instance. Note Braze hosts their application on multiple clusters throughout the US and EU.  


4. Click Continue.

Export a Mixpanel Cohort To Braze

To export a Mixpanel cohort, you must create a cohort. To export a Mixpanel cohort to Braze:

1. Click Data Management at the top of Mixpanel. Navigate to Cohorts.


2. Select the cohort to send to Braze. Select Export to Braze.


3. Select a One-time export or a Dynamic sync. Click Begin Sync.


Use the Mixpanel Cohort to Create a Segment in Braze

A new Braze segment can be built using a Mixpanel cohort after exporting a cohort from Mixpanel to Braze.

In order to build a Braze Segment after importing a cohort:

1. Select Segments tab under Engagement.


2. Click Create Segment.


3. After naming the Segment, click Select Filter from the dropdown.


4. Select "Mixpanel Cohorts".


5. Select the “includes” value from the dropdown. Click Search for a value from the dropdown.


6. The exported Mixpanel cohort isvisible in the dropdown. Select the cohort.


7. Click Save.

Matching Mixpanel and Braze Users

Users are matched in Mixpanel and Braze by the braze external id. This value must be a  $braze_external_id user profile property in Mixpanel, and must be an external user id in Braze. These values must match. 

The Mixpanel SDK automatically sets this property if the Braze SDK is in your application and if you have declared the external user ID via Braze's SDK. Note that you must explicitly declare the external user ID as part of your Braze implementation; the Braze SDK will not automatically set it, and the Mixpanel SDK will not be able to automatically set this property if it is not present via the Braze SDK.

Users will not sync if the  $braze_external_id  property is not applied to Mixpanel user profiles for users that are to be exported to Braze.

Similarly, the users will not be imported into Braze from Mixpanel if the external user id is not assigned to users in Braze.

Braze Events into Mixpanel & MTU exemptions

You can export events from your Braze integration to Mixpanel to perform deeper analysis. For detailed instructions on how to do this, please refer to Braze’s Technology Partner’s documentation.

Events coming from Braze are marked with the property "$partner_id".

Mixpanel will exempt certain messaging outreach events from MTU calculations, meaning you're free to send campaigns to dormant users without them counting towards MTU billing (only once a user engages with a message will they then be counted towards that tally).

The following events are exempt from MTU calculations:

  • Canvas Entry
  • Email Send
  • Email Delivery
  • Email Bounce
  • Email Soft Bounce
  • Email Mark As Spam
  • Email Unsubscribe
  • Push Notification Send
  • Push Notification Bounce
  • Webhook Send
  • SMS Send
Did this answer your question?



Please sign in to leave a comment.