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.
Adjust allows you to import non-organic install attribution data to segment more intelligently within your lifecycle campaigns.
Requirements
This integration supports iOS and Android apps.
Requirement | Description |
---|---|
Braze SDK | Be sure to enable the proper SDK for your needs - either Android or iOS. |
Braze API Key & REST Endpoint | In your Braze account, navigate to Technology Partners and search for Adjust. There, you’ll be able to find your rest endpoint and generate a Data Import Key. The Data Import Key and REST Endpoint will be used to set up a postback in Adjust’s dashboard. |
Adjust SDK | Please see the Adjust docs for more information on this requirement. |
If you have an Android app, you will need to include the code snippet below, which passes a unique Braze device ID to Adjust. You should call the following before initializing the SDK on Adjust.onCreate.
:
1
Adjust.addSessionPartnerParameter("braze_device_id", Appboy.getInstance(getApplicationContext()).getInstallTrackingId()););
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 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 need to set up product_id
as a parameter for events. For more information on defining partner parameters for event forwarding see Adjust’s documentation.
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 section of the Braze dashboard.
Integration
To integrate Braze with Adjust, you must configure Braze in Adjust’s dashboard.
- In Adjust’s dashboard, navigate to App Settings and navigate to Partner Setup, then Add Partners.
- Select Braze (formerly Appboy).
- Copy the Braze Data Import Key into the
Install API Key
field.
This Data Import Key is available in the Braze Dashboard. This can be found by navigating to Technology Partners under Integrations and selecting Adjust. Here, you can generate a new key or invalidate an existing key. From here, the API you need is housed under the Data Import for Install Attribution section. - Copy your specific Braze REST Endpoint into the
REST_endpoint
field. - Click Save & Close.
Attribution Parameters
Assuming you configure your integration as suggested above, Braze will map Adjust’s data to segment filters as described below.
Adjust Attribution Parameter | Braze Segment Filter |
---|---|
{network_name} | Attributed Source |
{campaign_name} | Attributed Campaign |
{adgroup_name} | Attributed Adgroup |
{creative_name} | Attributed Ad |
At this time, Braze only receives non-organic install attribution data from these attribution partners. This means that organic data will not appear as an attributed source within Braze.
Facebook and Twitter Attribution Data
Attribution data for Facebook and Twitter campaigns is not available through our partners. Facebook and Twitter 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. To improve the accuracy of attributions from your Braze campaigns, we recommend appending your Adjust tracking links with a device identifier. 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 Liquid logic below:
1
2
3
{% if most_recently_used_device.${platform} == 'android' %}
gps_adid={{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 Liquid logic below:
1
2
3
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}
This recommendation is purely optional
If you currently do not use any device identifiers - such as the IDFV or GAID - in your click tracking links, or do not plan to in the future, Adjust will still be able to attribute these clicks through their probabilistic modeling.