AppsFlyer

AppsFlyer is a mobile marketing analytics and attribution platform that helps you analyze and optimize your apps through marketing analytics, mobile attribution, and deep linking.

The Braze and AppsFlyer integration allows you to better understand how to optimize and build more holistic campaigns by leveraging mobile install attribution data from AppsFlyer.

You can also pass your AppsFlyer audiences (cohorts) directly to Braze with the AppsFlyer Audiences integration, allowing you to create powerful customer engagement campaigns targeted toward just the right users at just the right time.

Prerequisites

Integration

Step 1: Map device ID

• android
• ios
• unity

1
2
3
4
5
val customData = HashMap<String, Any>()
Braze.getInstance(context).getDeviceIdAsync { deviceId ->
   customData["brazeCustomerId"] = deviceId
   setAdditionalData(customData)
}

1
2
3
4
5
6
let configuration = Braze.Configuration(
    apiKey: "<BRAZE_API_KEY>",
    endpoint: "<BRAZE_ENDPOINT>")
configuration.useUUIDAsDeviceId = false
let braze = Braze(configuration: configuration)
AppsFlyerLib.shared().customData = ["brazeDeviceId": braze.deviceId]

1
2
3
4
5
6
BRZConfiguration *configurations = [[BRZConfiguration alloc] initWithApiKey:@"BRAZE_API_KEY" endpoint:@"BRAZE_END_POINT"];
[configurations setUseUUIDAsDeviceId:NO];
Braze *braze = [[Braze alloc] initWithConfiguration:configurations];
[[AppsFlyerLib shared] setAdditionalData:@{
    @"brazeDeviceId": braze.deviceId
}];

1
2
3
4
Appboy.AppboyBinding.getDeviceId()
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("brazeCustomerId", Appboy.AppboyBinding.getDeviceId());
AppsFlyer.setAdditionalData(customData);

Step 2: Get the Braze data import key

In Braze, navigate to Partner Integrations > Technology Partners and select AppsFlyer.

Here, you find the REST endpoint and generate your Braze data import key. After the key is generated, you can create a new key or invalidate an existing one. The data import key and the REST endpoint are used in the next step when setting up a postback in AppsFlyer’s dashboard.

Step 3: Configure Braze in AppsFlyer’s dashboard

1. In AppsFlyer, navigate to the Integrated Partners page on the left bar. Next, search for Braze and select the Braze logo to open a configuration window.
2. Within the Integration tab, switch on Activate Partner.
3. Provide the data import key and REST endpoint that you found in the Braze dashboard.
4. Toggle Advanced Privacy off and save your configuration.

Additional information on these instructions is available in AppsFlyer’s documentation.

Step 4: Confirm the integration

After Braze receives attribution data from AppsFlyer, the status connection indicator on the AppsFlyer technology partners page in Braze changes from “Not Connected” to “Connected” and includes a timestamp of the last successful request.

This status changes only after Braze receives data about an attributed install. Braze ignores organic installs (excludes them from the AppsFlyer postback) and does not count them when determining if the connection is successful.

Step 5: Viewing user attribution data

Available data fields

If your integration was successful, Braze maps all non-organic install data to segment filters.

You can segment your user base 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.

Integrate AppsFlyer with Braze for deep linking

Deep links—links that direct users toward a specific page or place within an app or website—are used to create a tailored user experience.

While widely used, issues can arise when using emailed deep links with click tracking#8212another important feature used in collecting user data. These issues are due to Email Service Providers (ESPs) wrapping deep links in a click-recording domain, breaking the original link. As such, supporting deep links requires additional setup.

AppsFlyer provides a service that avoids these issues, enabling AppsFlyer to serve as an intermediary between the ESP server and your domain name. Its role as a proxy enables the provision of association files (AASA/asset links), which facilitates deep linking.

Step 1 - Create a Click Tracking Domain

Following the initial elements of Braze’s Email set-up guidance, create an email sending domain and a click tracking domain. For support, you can raise a ticket via the Braze Dashboard to initiate setup for the new CTD with the Braze Email team.

Creating a new CTD is mandatory, even if you already use an existing one. This ensures that there is no impact on the traffic of current live email campaigns.

Step 2 - Create a OneLink Template in AppsFlyer

Create a OneLink template and configure Universal Links/App Links under “When app is installed”. This template is used later to create OneLink links for your email campaigns.

Step 3 - Set up your Braze Integration in Appsflyer

Now it’s time to set your Braze integration in AppsFlyer. This step and the following one (“Configure your app”) can be set up at the same time. To set your Braze integration in AppsFlyer:

1. In AppsFlyer, from the side menu, select Engage > ESP integration.

2. Select Braze.

3. Select the OneLink template you want to use for email campaigns, then click Next.

4. Enter your click tracking domain and “Braze endpoint” value, which was provided with the new CTD created in step 1, then click Validate connection.

This validates that the click-tracking domain points to the endpoint you entered.

By “Braze Endpoint”, AppsFlyer is asking for the details provided by Braze in Step 1 of this guide, specifically the new CTD.

Then click Validate connection, which validates that the click-tracking domain points to the endpoint you entered. When done, click Next.

5. Route link traffic to AppsFlyer:

a. Copy and send the customized pre-fabricated instructions in AppsFlyer to your IT or domain administrator.

Your administrator must reroute your email campaign traffic from the ESP servers to the AppsFlyer servers by updating your DNS CNAME records with the new domain that AppsFlyer provided.

As a result, every time a link is clicked, the click is redirected to AppsFlyer, which in turn redirects it to the ESP endpoint.

b. After copying and sending the instructions, click Done.

Your Braze integration has been created.

Step 4: Configure your App (Developer-Task)

Appsflyer offers guidance on correct app configuration, which should be followed by your web or app teams in order to support universal linking.

Step 5: Confirm SSL Click-tracking is enabled with Braze

At this stage, after you share and validate the CTD details in Appsflyer, we recommend performing a test send to confirm if your Onelink sending domain has an SSL certificate. This is in line with our Email Setup guide.

You can perform quality assurance and troubleshooting by sending a deep link using OneLink. See the AppsFlyer documentation for details on using OneLink.

If CTD links are identified as HTTP, contact Braze’s Email Ops team to enable SSL click-tracking. This ensures that all HTTP links are automatically converted to HTTPS. You can use the following sample message text when contacting your Customer Success Manager, or by raising a ticket in the Braze Dashboard again, like in step 1:

1
2
Hi Team,
Could you please enable SSL click tracking for CTD XXX? It is currently set to HTTP instead of HTTPS. 

AppsFlyer click tracking URLs in Braze (optional)

You can use AppsFlyer’s OneLink attribution links in Braze campaigns across push, email, and more. This allows you to send back install or re-engagement attribution data from your Braze campaigns into AppsFlyer. As a result, you can measure your marketing efforts more effectively and make data-driven decisions.

You can simply create your OneLink tracking URL in AppsFlyer and directly insert it into your Braze campaigns. AppsFlyer then uses their probabilistic attribution methodologies to attribute the user that has clicked on the link. We recommend appending your AppsFlyer tracking links with a device identifier to improve the accuracy of attributions from your Braze campaigns. This deterministically attributes the user that has clicked on the link.

• android
• ios

1
2
3
{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}

1
2
3
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}