|
| 1 | +--- |
| 2 | +title: Braze |
| 3 | +keywords: |
| 4 | + - owner:danielwest |
| 5 | +last_update: |
| 6 | + date: 2025-04-22 |
| 7 | +--- |
| 8 | + |
| 9 | +## Overview |
| 10 | + |
| 11 | +Enabling the Braze integration allows you to export Statsig exposure events to your configured Braze app with information on the status of each user's feature gate and experimentation groups. These exposures will be forwarded to Braze as a [Custom Attribute](https://www.braze.com/docs/user_guide/data/custom_data/custom_attributes) object on the user. There will be one Custom Attribute per gate/experiment the user has been exposed to. The Custom Attribute in Braze will be named `statsig_exposure::{gate/experiment name}` and be of the form: |
| 12 | + |
| 13 | +``` |
| 14 | +{ |
| 15 | + group_name: String, |
| 16 | + timestamp: Time |
| 17 | +} |
| 18 | +``` |
| 19 | + |
| 20 | +You can then filter exposed users into a Segment in Braze. Custom Attributes will be forwarded to Braze users by having the unit ID from the gate/experiment as the `external_id` in Braze. |
| 21 | + |
| 22 | +## Setup in Statsig |
| 23 | + |
| 24 | +This integration is only available for Statsig Enterprise customers. Please reach out to our support team to get this enabled for your project. Then, you will be able to find 'Braze' as an option in your Statsig project's [list of integrations](https://console.statsig.com/integrations) from within Statsig console. |
| 25 | + |
| 26 | +1. Open your [Braze dashboard](https://dashboard.braze.com/). Navigate to Settings > APIs and Identifiers, then open the API Keys tab. |
| 27 | +2. Create or select an existing API key that has the 'users.track' permission. Enter the API Key Identifier in the Braze Integration Setup dialog in your Statsig project. |
| 28 | +3. Find your Instance's REST Endpoint from the [Braze API docs](https://www.braze.com/docs/api/basics/#api-definitions/). Enter it in the Integration Setup dialog. |
| 29 | + |
| 30 | +## Segment Filtering in Braze |
| 31 | + |
| 32 | +Once your integration is set up in Statsig, exposures can start firing into your Braze app. When exposures arrive in Braze from a new gate/experiment, you can create a filter on these users. |
| 33 | + |
| 34 | +1. Open your [Braze dashboard](https://dashboard.braze.com/). Navigate to Data Settings > Custom Attributes. You should see your new Custom Attribute from Statsig like below: |
| 35 | + |
| 36 | + |
| 37 | + |
| 38 | +2. Click 'Generate Schema'. It will automatically detect the schema like below: |
| 39 | + |
| 40 | + |
| 41 | + |
| 42 | +3. Now you can create a Segment from these users. Navigate to Audience > Segments, and click 'Create Segment'. |
| 43 | + |
| 44 | +4. Under the 'Segment Builder' section, add a new filter. Click 'Custom Attributes', then 'Nested Custom Attributes'. |
| 45 | + |
| 46 | + |
| 47 | + |
| 48 | +5. Now you can filter to a specific group_name (true/false for gates, group name for experiments), or timestamp for your set of users. An example Segment filter for all users that have passed a specific gate is like below: |
| 49 | + |
| 50 | + |
0 commit comments