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.

Integration

To integrate Braze with Adjust, you must configure Braze in Adjust’s dashboard.

  1. In Adjust’s dashboard, navigate to App Settings and navigate to Partner Setup, then Add Partners.

  2. Select Braze (formerly Appboy).

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

    Adjust Image

  4. Copy your specific Braze REST Endpoint into the REST_endpoint field.

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

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.

WAS THIS PAGE HELPFUL?
New Stuff!