Skip to content

Adjust

Adjust is a mobile attribution and analytics company that combines attribution for advertising sources with advanced analytics for a comprehensive picture of business intelligence.

The Braze and Adjust integration lets you import non-organic install attribution data to segment more intelligently within your lifecycle campaigns.

Prerequisites

Requirement Description
Adjust account An Adjust account is required to take advantage of this partnership.
iOS or Android app This integration supports iOS and Android apps. Depending on your platform, code snippets may be required in your application. Details on these requirements can be found in step 1 of the integration process.
Adjust SDK In addition to the required Braze SDK, you must install the Adjust SDK.

Integration

Step 1: Map device IDs

Android

If you have an Android app, you will need to pass a unique Braze device ID to Adjust. This ID can be set in the Adjust SDK’s addSessionPartnerParameter() method. The following code snippet must be included before initializing the SDK on Adjust.onCreate.

1
Adjust.addSessionPartnerParameter("braze_device_id", Braze.getInstance(getApplicationContext()).getDeviceId()););

iOS

If you have an iOS app, your IDFV will be collected by Adjust and sent to Braze. This ID will then be mapped to a unique device ID in Braze.

Braze will still store IDFA values for users that have opted-in if you are collecting the IDFA with Braze, as described in our iOS 14 Upgrade Guide. Otherwise, the IDFV will be used as a fallback identifier to map users.

If you have an iOS app, you may opt to collect IDFV by setting the useUUIDAsDeviceId field to false. If not set, iOS attribution will likely not map accurately from Adjust to Braze. For more information, refer to Collecting IDFV.

Step 2: Get the Braze data import key

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

Here, you will 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 Adjust’s dashboard.

This image shows the "Data Import for Install Attribution" box found in the Adjust technology page. In this box, you are shown the data import key and the REST endpoint.

Step 3: Configure Braze in Adjust

  1. In Adjust’s dashboard, navigate to App Settings and navigate to Partner Setup, then Add Partners.
  2. Select Braze (formerly Appboy) and provide the data import key and Braze REST endpoint.
  3. Click Save & Close.

Step 4: Confirm the integration

Once Braze receives attribution data from Adjust, the status connection indicator on the Adjust technology partners page in Braze will change from “Not Connected” to “Connected”. A timestamp of the last successful request will also be included.

Note that this will not happen until we receive data about an attributed install. Organic installs, which should be excluded from the Adjust postback, are ignored by our API and are not counted when determining if a successful connection was established.

Available data fields

Assuming you configure your integration as suggested, Braze will map Adjust’s data to segment filters as described in the following table.

Adjust data field Braze segment filter
{network_name} Attributed Source
{campaign_name} Attributed Campaign
{adgroup_name} Attributed Adgroup
{creative_name} Attributed Ad

Facebook and X (formerly Twitter) attribution data

Attribution data for Facebook and X (formerly Twitter) campaigns is not available through our partners. These media sources do not permit their partners to share attribution data with third parties and, therefore, our partners cannot send that data to Braze.

Adjust click tracking URLs in Braze (optional)

Using click tracking links in your Braze campaigns will allow you to easily see which campaigns are driving app installs and re-engagement. As a result, you’ll be able to measure your marketing efforts more effectively and make data-driven decisions on where to invest more resources for the maximum ROI.

To get started with Adjust click tracking links, visit their documentation. You can insert the Adjust click tracking links into your Braze campaigns directly. Adjust will then use their probabilistic attribution methodologies to attribute the user that has clicked on the link. We recommend appending your Adjust tracking links with a device identifier to improve the accuracy of attributions from your Braze campaigns. This will deterministically attribute the user that has clicked on the link.

For Android, Braze allows customers to opt-in to Google Advertising ID collection (GAID). The GAID is also collected natively through the Adjust SDK integration. You can include the GAID in your Adjust click tracking links by utilizing the following Liquid logic:

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

For iOS, both Braze and Adjust automatically collect the IDFV natively through our SDK integrations. This can be used as the device identifier. You can include the IDFV in your Adjust click tracking links by utilizing the following Liquid logic:

1
2
3
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}
HOW HELPFUL WAS THIS PAGE?
New Stuff!