Braze (Cohort Sync)

Amplitude Data's Braze integration lets you send your Amplitude cohorts to Braze with just a few clicks.

Considerations

• You must enable this integration in each Amplitude project you want to use it in.
• You need a paid Amplitude plan to enable this integration.
• For more details on using this integration in Braze, go to the Braze documentation.
• You must have a Braze account.
• Amplitude sends email alerts for job success and failures, keeping you informed about the status of your cohort syncs.
• Identified users can be matched by either their external_id or alias. Anonymous users can be matched by their device_id. Identified users who were originally created as anonymous users can’t be identified by their device_id, and must be identified by their external_id or alias. Set up multiple user identifier mappings in a hierarchical order, so if the first mapping doesn’t match, the next is applied, allowing more users to be included in your sync.

Prerequisites

To configure a cohort integration from Amplitude to Braze, you need the following information from Braze:

1. Data Import Key

   • In Braze, click Partner Integrations then click on Amplitude and Generate New Key. This is the Braze REST API key.
   • Go to Braze documentation for more detail.

2. Endpoint: the endpoint for the REST operations

   • In Braze, click on Partner Integrations and click Amplitude.
   • It looks like: https://rest.iad-##.braze.com. Go to the Braze documentation to find your endpoint.

Amplitude setup

1. In Amplitude Data, click Catalog and select the Destinations tab.
2. In the Cohort section, click Braze.
3. Enter your App Group REST API key, select your endpoint, and paste your Data Import Key.
4. Select the hierarchy of mappings you want to map users to.

• If you select User alias as the target object, add a User alias label. Otherwise, you can leave it empty.

6. When finished, save.

Send a cohort

To sync your first cohort, follow these steps:

1. In Amplitude, open the cohort you want to sync, then click Sync.
2. Select Braze, then click Next.
3. Choose the account you want to sync to.
4. Choose the sync cadence. Select One-Time Sync, Scheduled Sync, or Real-Time sync. For more information about cohort syncing, see Sync to third-party destinations.
5. When finished, save your work.

Use the cohort in Braze

1. In Braze, to create a segment of these users, navigate to Audience and click on Segments.
2. Click on Create Segment and name your Segment.
3. Under Add Filter, select Amplitude Cohorts and choose the cohort you created and synced from Amplitude.
4. When saved, you can reference this segment during Canvas or campaign creation in the targeting users step.

Email notifications

Amplitude automatically sends email alerts for cohort sync jobs:

• Success notifications: Receive confirmation when your cohort sync to Braze completes successfully.
• Failure notifications: Get alerted when a sync job fails, allowing you to address any issues.

These notifications help you monitor the status of your cohort syncs without having to manually check the platform.

Troubleshooting

I don't see a list of users in Braze

When you sync a cohort, Braze matches users in that cohort with users that already exist in Braze, and doesn't create new users. Make sure users in your Amplitude cohort have a matching user (userId) in Braze.