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.

This integration is maintained by Adjust.

About the integration

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 must pass a unique Braze device ID to Adjust. This ID can be set in the Adjust SDK’s addGlobalPartnerParameter() method. The following code snippet must be included before initializing the SDK on Adjust.initSdk.

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

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 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.

note

If you are planning to send post-install events from Adjust into Braze, you will need to:

1) Ensure that you append external_id as a session and event parameter within the Adjust SDK. For revenue event forwarding, you will also need to set up product_id as a parameter for events. Visit Adjust’s documentation for more information on defining partner parameters for event forwarding.

2) Generate a new API key to input into Adjust. This can be done by selecting the Generate API Key button found within the Adjust partner page in the Braze dashboard.

Step 2: Get the Braze data import key

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

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 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

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

Step 4: Confirm the integration

On the Adjust technology partners page in Braze, the connection indicator shows Not Connected until you generate a data import API key in Step 2. After you generate the key, the indicator changes to Connected and displays a timestamp. That timestamp reflects when the integration was first set up in Braze (when the data import key was created), not when Adjust last sent a postback.

To confirm that install attribution data is flowing from Adjust, check that non-organic install data appears in Braze segment filters. Braze ignores organic installs from Adjust postbacks and does not store them as attributed install data.

Available data fields

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

Adjust data field	Braze segment filter
`{network_name}`	Install Attribution Source
`{campaign_name}`	Install Attribution Campaign
`{adgroup_name}`	Install Attribution Adgroup
`{creative_name}`	Install Attribution 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.

android
ios

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:

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

For iOS, append the Braze device identifier to improve deterministic attribution. In Liquid, most_recently_used_device.${id} is the Braze device ID, which may be the IDFV or a UUID depending on your Swift SDK useUUIDAsDeviceId setting. Adjust click-tracking URLs commonly use an idfv query parameter for this value:

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

note

This recommendation is purely optional
If you currently do not use any device identifiers—such as the Braze device ID or GAID—in your click tracking links, or do not plan to in the future, Adjust can still attribute these clicks through their probabilistic modeling.

New Stuff!