Adjust Destination

Send your event data from RudderStack to Adjust.

Adjust is an industry-leading mobile attribution provider that allows you to bring all your business data together to get powerful insights from it.

RudderStack supports Adjust as a destination to which you can seamlessly send your event data.

Find the open source transformer code for this destination in the GitHub repository. You can also refer to the specific repositories for the Android and iOS implementations.

Connection compatibility

Destination info
  • Status: Generally Available
  • Supported sources: Android, iOS , Unity, Cloud, Warehouse, React Native , Flutter, Cordova, Shopify
  • Refer to it as ADJ in the Integrations object.

Connection modes
SourceCloud modeDevice modeHybrid mode
Androidsupportedsupportednot supported
Cloudsupportednot supportednot supported
Cordovasupportednot supportednot supported
Fluttersupportedsupportednot supported
iOSsupportedsupportednot supported
React Nativesupportednot supportednot supported
Shopifysupportednot supportednot supported
Unitysupportedsupportednot supported
Warehousesupportednot supportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAliasRecord
Cloud mode
Supported sourcesnot supportednot supportedsupportednot supportednot supportednot supportednot supported
Device mode
Androidsupportednot supportedsupportednot supportednot supportednot supportednot supported
Fluttersupportednot supportedsupportednot supportednot supportednot supportednot supported
iOSsupportednot supportedsupportednot supportednot supportednot supportednot supported
Unitysupportednot supportedsupportednot supportednot supportednot supportednot supported

Get started

Once you have confirmed that the platform supports sending events to Adjust, follow these steps:

  1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select Adjust.
  2. Assign a name to the destination and click Continue.

Connection settings

SettingDescription
App TokenEnter your Adjust app token.
Send to production environment in AdjustTurn on this toggle to send the data to the production environment in Adjust.

By default, RudderStack sends the data to the Adjust sandbox environment.
Client-side events filteringThis setting lets you specify which events should be blocked or allowed to flow through to Adjust. See the Client-side Events Filtering guide for more information on this feature.

Note: This setting is applicable only when sending events to Adjust in device mode.
Map events to Adjust event tokensThis setting lets you map the RudderStack events to Adjust’s event tokens. See the FAQ for more information on creating an event token in Adjust.
RudderStack parameters to Adjust partner parametersThis setting lets you map your event properties to specific Adjust partner parameters.
Delay time before SDK initializationUse this setting to initiate a delay in loading the SDK for the first time.

Note: This setting is applicable only for sending events to Adjust in device mode.
Use device mode to send eventsTurn on this toggle for the Android/iOS SDK to send events to Adjust in device mode.

warning
Do not add native Adjust SDK to your project as it will prevent you from integrating it successfully.
Consent management settingsConfigure the consent management settings for the specified source by choosing the Consent management provider from the dropdown and entering the relevant consent category IDs.

See Consent Management in RudderStack for more information on this feature.

Add device mode integration

Follow these steps to add Adjust to your project depending on your integration platform:

Identify

RudderStack’s identify call lets you identify a visiting user and associate them to their actions.

RudderStack sends the user information in the identify call to Adjust’s addSessionPartnerParameter method to set the userId (or anonymousId, in case userId is absent), so that the user information is passed to the subsequent calls.

A sample identify call is shown below:

[[RudderClient sharedInstance] identify:@"developer_user_id"
                                 traits:@{@"foo": @"bar", @"foo1": @"bar1"}];

Track

The track call lets you record the user actions along with any properties associated with them.

When you make a track call, RudderStack maps the event name with the corresponding Adjust custom event in the dashboard using Adjust’s trackEvent method.

warning

Make sure to define the event mapping in the Map events to Adjust Event Tokens dashboard setting. Adjust will reject any events apart from these mappings.

Note that you must create the event token in the Adjust dashboard before specifying the mappings.

Send callback parameters

RudderStack sends all custom properties in your track calls as callback parameters.

A sample track call is shown below:

[[RudderClient sharedInstance] track:@"test_event"
                          properties:@{@"key":@"value", @"foo": @"bar"}];

Send partner parameters

You can also send custom properties in your track calls as partner parameters to Adjust. Adjust then sends those parameters to the external partners you have set up in your Adjust dashboard. See the FAQ below for more information on adding a partner in Adjust.

RudderStack uses the property mappings specified in the RudderStack Parameters to Partner Parameters dashboard setting to check if a key is present in the track event properties and maps it to the corresponding Adjust partner parameter object.

warning

Note that:

  • Adjust will reject any properties apart from mappings specified in the RudderStack Parameters to Partner Parameters dashboard setting.
  • The partner parameters only accept the String data type.

Suppose a customer sets the following mappings in the RudderStack dashboard:

RudderStack propertyAdjust partner parameter
revenueprice
quantityquantity

A sample track call with the above properties is shown below:

[[RudderClient sharedInstance] track:@"purchase"
                          properties:@{@"revenue":@20.99,
                          @"currency": @"USD",
                          @"quantity": @10}];

The corresponding Adjust payload highlighting the parameters is shown below:

"params": {
  "android_id": "3f034872-5e28-45a1-9eda-ce22a3e36d1a",
  "gps_adid": "3f034872-5e28-45a1-9eda-ce22a3e36d1a",
  "att_status": 3,
  "tracking_enabled": true,
  "currency": "USD",
  "ip_address": "[::1]",
  "s2s": 1,
  "app_token": "t1yurrb968zk",
  "event_token": "tf4gm5",
  "environment": "production",
  "partner_params": {"price":"20.99","quantity":"10"}
},
info
RudderStack converts numeric values into strings before sending the data to Adjust.

Send revenue tracking events

To send revenue tracking events to Adjust, your can add total and currency to your event properties:

[[RudderClient sharedInstance] track:@"purchase"
                          properties:@{@"total":@2.99, @"currency": @"USD"}];

Reset

You can use RudderStack’s reset method to call resetSessionCallbackParameters method of the Adjust SDK to reset the user ID and the associated traits.

A sample reset call is shown below:

[[RudderClient sharedInstance] reset];

App install attribution

Adjust’s native SDK handles app install attribution out of the box with RudderStack.

warning
This feature is not supported when sending events via cloud mode.

For testing install attribution and troubleshooting tips, refer to the Adjust documentation.

Adjust environment dependency on log level

FAQ

Where can I find the Adjust app token?

To get your Adjust app token, follow these steps:

  1. Log into your Adjust dashboard.
  2. Find your app and select the app options caret (^):
Adjust app token
  1. You will find your app token listed here.
Adjust app token

How can I create a new event token in Adjust?

To create a new event token, follow these steps:

  1. Log into your Adjust dashboard.
  2. Find your app and select the app options caret (^):
Adjust app token
  1. Go to All Settings > Events:
Adjust event token
  1. Under CREATE NEW EVENT, enter the name of the event token and click CREATE.

How can I set up new partners in Adjust?

Adjust lets you provide additional data to certain integrated partners. To set up a new partner in Adjust, follow these steps:

  1. Log into your Adjust dashboard.
  2. Find your app and select the app options caret (^):
Adjust app token
  1. Go to All Settings > Partner Setup > ADD PARTNERS:
Adjust partner setup
  1. Select the partner from the list and click the + option on the right to add.
  2. Enter the relevant details to complete the configuration and click SAVE to complete the setup.

Questions? Contact us by email or on Slack