At a glance: Braze, an AppsFlyer integrated partner, offers a lifecycle engagement platform for marketing, growth, and engagement teams. The platform enables marketers to connect human-to-human, at scale, with their customers, driving deep engagement and ROI. The center of our platform is the holistic user profile that offers a single view of the customer.
Learn more at braze.com.
Important!
Some media sources restrict sharing data with third parties. Therefore, postbacks for restricted events won't be sent to this partner, regardless of the configured selection for sending postbacks.
Integration overview
Follow the instructions below to configure the integration with Braze.
Minimum requirements - AppsFlyer SDK:
On Android, integrating with Braze requires that the Braze Device ID (Braze unique user identifier) is populated in AppsFlyer Android SDK. This parameter is sent with every postback and enables the identification of each user. To perform this you must insert the following strings to your app code:
Important Note
Make sure the lines of code are inserted at the correct place – after Braze SDK is launched and before the initialization code for AppsFlyer SDK (see the Initializing the SDK section in our Android SDK Integration Guide).
HashMap<String, Object> customData = new HashMap<String,Object>();
String deviceId =(Braze.getInstance(MyActivity.this).getDeviceId());
customData.put("brazeCustomerId", deviceId);
AppsFlyerLib.getInstance().setAdditionalData(customData);
Swift
There are two Swift APIs, one with a completion handler and another using the new Swift concurrency support. They both produce the same value—choosing which to use depends on the context.Swift completion handler
let configuration = Braze.Configuration(
apiKey: "<BRAZE_API_KEY>",
endpoint: "<BRAZE_ENDPOINT>")
configuration.useUUIDAsDeviceId = false
let braze = Braze(configuration: configuration)
braze.deviceId {
brazeDeviceId in
AppsFlyerLib.shared().customData = [“brazeDeviceId”: brazeDeviceId]
}
Swift await
let configuration = Braze.Configuration(
apiKey: "<BRAZE_API_KEY>",
endpoint: "<BRAZE_ENDPOINT>")
configuration.useUUIDAsDeviceId = false
let braze = Braze(configuration: configuration)
let brazeDeviceId = await braze.deviceId()
AppsFlyerLib.shared().customData = ["brazeDeviceId": brazeDeviceId]
Objective-C
BRZConfiguration *configurations = [[BRZConfiguration alloc] initWithApiKey:@"BRAZE_API_KEY" endpoint:@"BRAZE_END_POINT"];
[configurations setUseUUIDAsDeviceId:NO];
Braze *braze = [[Braze alloc] initWithConfiguration:configurations];
[braze deviceIdWithCompletion:^(NSString * _Nonnull brazeDeviceId) {
NSLog(@">>[BRZ]: %@", brazeDeviceId);
[[AppsFlyerLib shared] setAdditionalData:@{
@"brazeDeviceId": brazeDeviceId
}];
}];
Appboy.AppboyBinding.getDeviceID()
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("brazeCustomerId", Appboy.AppboyBinding.getDeviceId());
AppsFlyer.setAdditionalData(customData);
Setting up Braze
Prerequisite: Before setting up the integration, make sure you contact the partner and open an account with them.
To activate or edit the integration:
-
To activate: In AppsFlyer, from the side menu, select Collaborate > Partner Marketplace.
To edit: In AppsFlyer, from the side menu, select Collaborate > Active Integrations. - Search for the partner and select it.
- Click Set up integration. You’re directed to the integration setup page.
- In the Integration tab, select the app for the integration and turn Activate partner on.
Note: The toggle must be on (activated) for as long as you work with the partner. - Complete the configuration using the relevant tabs, as described below.
For a detailed description of the Partner Configuration Window Header, click here.
Integration tab
The Integration Tab is divided into different sections as described below.
Activate partner
On the first visit here, you must Activate the Partner to enable the setup of the integration tab parameters. The toggle MUST be ON for as long as you work with the partner.
For more details about partner activation please click here.
General settings
Braze connects with AppsFlyer via a unique API Key and REST Endpoint.
To get Braze's API Key and REST endpoint:
- In your Braze account, under Technology Partners, go to Attribution.
- Select AppsFlyer.
- Under Data Import for Install Attribution, click Generate API Key.
- Copy the generated API Key and the REST endpoint.
- In AppsFlyer, insert the Braze API Key and the REST endpoint.
- Click Save and Close
Once you have saved the configuration, AppsFlyer sends the following data to Braze for every organic and non-organic install:
- Braze Dev_ID
- Media Source
- Campaign name
- Adgroup name
- Ad name
Default postbacks
AppsFlyer can send automatic postbacks to Braze user installs. Use this section to define sending these postbacks.
Select Events attributed to any partner or organic to send postbacks to Braze for any user that downloads the app.
Click Save.
Note
Although all events are sent by AppsFlyer, organic installs are not counted by Braze and therefore are ignored by the Braze API.
Attribution link tab
Attribution Links are not available for Braze.
Cost tab
Cost data is not supported in the integration with this partner.
Ad revenue tab
Ad Revenue is not supported in the integration with this partner.
Permissions tab
Permissions are not available for Braze.
Viewing user attribution data in Braze
Your user base can be segmented by attribution data in the Braze dashboard using the Install Attribution filters.
Additionally, attribution data for a particular user is available on each user’s profile in the Braze dashboard.