Braze Cohorts Destination

Braze is an engagement platform that empowers growth by helping marketing teams build customer loyalty through omni-channel customer experiences. The Braze Cohort API is a multi-channel marketing interface that allows you to import cohorts of users into Braze. These cohorts can be used to build better campaigns with the most accurate customer data.

Segment’s Braze Cohorts destination syncs Engage audiences to Braze as cohorts. This is a more scalable alternative to storing audience subscription in user-level attributes in Braze. It also is more efficient as audiences are uploaded as a list, as opposed to individual events.

Getting started

Before connecting to the Braze Cohorts destination, you must have a Braze account and an Ad Account ID.

To connect the Braze Cohorts destination:

1. From the Segment web app, navigate to Engage > Audiences. Ensure you are in the Engage space you plan to use with the Braze Cohorts destination. Either choose an existing Engage Audience or create a new one. This is the Audience you plan to send to Braze as a cohort.

2. Within the Audience, click Settings and copy the Audience Key. You’ll need this key later.

3. Navigate to Engage > Engage Settings and click Destinations. Please ensure you are still in the correct Engage space.

4. Search for “Braze Cohorts” and select the destination.

5. Click Configure Braze Cohorts.

6. On the Select Source screen, your Engage space should already be selected as the source. Click Confirm Source.

7. On the Destination Settings tab, name your destination and authenticate with Braze Cohorts using OAuth.

8. Once authenticated, input your Client Secret key from your Braze Dashboard account. Toggle “Enable Destination” on and click Save Changes.

9. Navigate to the Mappings tab, click New Mapping, and select Sync Audience.

10. Under Select mappings, input the Audience Key you copied in Step 2 as the “Segment Engage Audience Key.” Do not change any other defaults. Click Save and toggle to enable the mapping.
    • Note: Users can be added or removed from cohorts through ExternalId, DeviceId, or the UserAlias object. The priority is ExternalId, then DeviceId, and finally UserAlias if all are provided.
    • The Audience Key must be manually entered to ensure users in the Engage Audience are sent to the correct cohort in Braze. For every Engage Audience you want to send to Braze, a separate Sync Audience mapping must be created. You can create up to 50 mappings within an instance of the Braze Cohorts destination.

11. Navigate back to Engage > Audiences and click on the Audience from Step 1.

12. Click Add Destinations and select the Braze Cohorts destination you just created. In the settings that appear in the side panel, toggle the Send Track option on and do not change the Audience Entered/Audience Exited event names. Click Save Settings.

The setup is complete and the Audience will start syncing to Braze Cohorts. Segment will create a new cohort (if one does not already exist for the given Audience Key) and add/remove users to/from the cohort accordingly. The Audience appears in your Braze account, account under Engagement > Segments.

To sync additional Audiences from your Engage space, create a separate mapping in the Braze Cohorts destination. Navigate to Connections > Destinations, search and select the Braze Cohorts destination, and follow Steps 9-11 above.

Destination Settings

Available Actions

Build your own Mappings! Combine supported triggers with the following Braze Cohorts-supported actions:

• Sync Audience

Sync Audience

Record custom events in Braze

Sync Audience is a Cloud action. The default Trigger is: event = "Audience Entered" or event = "Audience Exited"

Click to show / hide fields