Incoming partner connection—Braze

At a glance: Send Braze message engagement events to AppsFlyer Audiences and use them to add precision to your audience definitions.

By setting up an incoming connection between your Braze account and AppsFlyer Audiences, you bring your Braze message engagement event data into Audiences. You can then use this data in rulesets when defining audiences.


  • Both the Braze and AppsFlyer SDKs must be integrated into your app.
  • You must subscribe to the Currents feature in Braze.

Set up the Braze incoming connection

There are 3 main steps for setting up the Braze incoming connection:

  1. Set up the AppsFlyer SDK
  2. Create an incoming connection in AppsFlyer
  3. Create a Current in Braze

Set up the AppsFlyer SDK

To create an incoming connection from Braze, the AppsFlyer SDK in your apps must be configured to pass each user's Braze External ID to AppsFlyer. You can do this using either:

  • Braze External ID parameter
  • CUID field

Using a Braze External ID parameter

You can configure a dedicated parameter to pass the Braze External ID to AppsFlyer using the setPartnerData function of the AppsFlyer SDK. Usage examples follow:

Map<String, Object> brazeData = new HashMap<>();
partnerData.put("external_user_id", "some-braze-external-id-value");
AppsFlyerLib.getInstance().setPartnerData("braze_int", brazeData);

Using the CUID field

There is no need to configure a dedicated parameter for the Braze External ID if:

  • You have configured the SDK to send AppsFlyer a CUID for each user
  • The CUID has the same value as the Braze External ID

In this case, you can simply select the CUID option as the SDK parameter when creating your incoming Braze connection.

Create an incoming Braze connection in AppsFlyer

Follow these steps to create an incoming connection in AppsFlyer:

  1. In AppsFlyer, from the side menu, select Engage > Audiences 
  2. In the Audiences page, go to Connections > Incoming tab.
  3. Click the New incoming connection button.
  4. Select Braze from the list of available partners.
  5. Click the Save button to create the connection.
    The Connection credentials dialog opens.
  6. Copy the connection credentials to use when setting up the connection to AppsFlyer Audiences in the Braze platform:
    • Access key ID
    • Secret access key
    • Bucket name
    • Folder path
  7. Select the SDK parameter you are using to send the Braze External ID:
    • Braze External ID
    • CUID

Create a Current in Braze

Follow these steps to create a Current in Braze:

  1. Go to the Integration section of the left-side menu bar.
  2. Click Currents.
  3. Click the Create Current button.
  4. Select Amazon S3 Data Export.
  5. In the Create Currents Integration section:
    1. Enter a name for the Current (for example, AppsFlyer Audiences).
    2. Enter the email of someone on your team that Braze will notify in case of issues with the credentials for the Current.
  6. In the Credentials section:
    1. Keep the option for AWS Secret Access Key selected (this is the default value).
    2. Enter the credentials you copied from AppsFlyer in the appropriate fields.
    3. Keep the Enable Encryption option unchecked.
  7. Under General Settings, keep Include events from anonymous users checked.
  8. In the Message Engagement Events section, select the events you want Braze to send to AppsFlyer. See the list of supported events below.
  9. In the Customer Behavior and User Events section, keep the Track Customer Behavior and User Events option turned off.
  10. Click the Launch Current button to save the configuration and start sending Braze message engagement events to Audiences.

 Supported Braze events

  • Subscription Group State Change
  • Email Click
  • Email Open
  • Email Send
  • Email Delivery
  • Email Mark as Spam
  • Email Unsubscribe
  • Email Bounce
  • Email Soft Bounce
  • Push Open
  • Push Send
  • Push Bounce
  • iOS Foreground Push
  • SMS/MMS Send

Using Braze data in Audiences

Once the Braze incoming connection is set up, the engagement events you've defined will appear as options in the ruleset filters for defining audiences.


Note: It takes approximately 24 hours for the Braze message engagement events to be available in AppsFlyer after you launch the current in Braze.