Adjust Destination

Send your event data from RudderStack to Adjust.

13 minute read

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 Information
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
Source	Cloud mode	Device mode	Hybrid mode
Android
Cloud
Cordova
Flutter
iOS
React Native
Shopify
Unity
Warehouse

Supported Message Types
Source	Identify	Page	Track	Screen	Group	Alias	Record
Cloud mode
Supported sources
Device mode
Android
Flutter
iOS
Unity

Get started

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

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

Connection settings

Setting	Description
App Token	Enter your Adjust app token.
Send to production environment in Adjust	Turn 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 filtering	This 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 tokens	This 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 parameters	This setting lets you map your event properties to specific Adjust partner parameters.
Delay time before SDK initialization	Use 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 events	Turn on this toggle for the Android/iOS SDK to send events to Adjust in device mode. Do not add native Adjust SDK to your project as it will prevent you from integrating it successfully.
Enable Install Attribution	Turn on this toggle to automatically track the `Install Attributed` event when the app is installed for the first time. See the App install attribution section for more information on this feature.
Consent management settings	Configure 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:

To add Adjust to your iOS project, follow these steps:

Add the following line to your CocoaPods Podfile:

pod 'Rudder-Adjust'

After adding the dependency, register the RudderAdjustFactory with your RudderClient initialization as a factory of RudderConfig. Run the following command to import RudderAdjustFactory.h file in your AppDelegate.m file:

#import <Rudder-Adjust/RudderAdjustFactory.h>

Then, change the SDK initialization to the following:

RudderConfigBuilder *builder = [[RudderConfigBuilder alloc] init];
[builder withDataPlaneUrl:DATA_PLANE_URL];
[builder withFactory:[RudderAdjustFactory instance]];
[RudderClient getInstance:WRITE_KEY config:[builder build]];

This device mode integration is supported for Adjust v4.29.7 and above.

To add Adjust to your iOS project, follow these steps:

Install RudderAdjust (available through CocoaPods by adding the following line to your Podfile):

pod 'RudderAdjust', '~> 1.0.0'

Run the pod install command.
Next, import the SDK depending on your preferred platform:

import RudderAdjust

@import RudderAdjust;

Add the imports to your AppDelegate file under the didFinishLaunchingWithOptions method:

let config: RSConfig = RSConfig(writeKey: WRITE_KEY)
            .dataPlaneURL(DATA_PLANE_URL)

RSClient.sharedInstance().configure(with: config)
RSClient.sharedInstance().addDestination(RudderAdjustDestination())

RSConfig *config = [[RSConfig alloc] initWithWriteKey:WRITE_KEY];
[config dataPlaneURL:DATA_PLANE_URL];

[[RSClient sharedInstance] configureWith:config];
[[RSClient sharedInstance] addDestination:[[RudderAdjustDestination alloc] init]];

Follow the steps in this section to add Adjust to your Kotlin project.

In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle), add the following dependencies for the RudderStack-Adjust integration:

dependencies {
  // ...
  
  // Add Rudder Kotlin and Adjust integration SDKs:
  implementation("com.rudderstack.sdk.kotlin:android:<latest-version>")
  implementation("com.rudderstack.integration.kotlin:adjust:<latest-version>")
}

For further steps — like adding the Google Play Services dependency, required AndroidManifest permissions, and ProGuard rules — refer to the Adjust documentation.
Add the SDK initialization and the Rudder-Adjust integration in your Application class:

import android.app.Application
import com.rudderstack.sdk.kotlin.android.Analytics
import com.rudderstack.sdk.kotlin.android.Configuration
import com.rudderstack.integration.kotlin.adjust.AdjustIntegration

class MyApplication : Application() {
    lateinit var analytics: Analytics

    override fun onCreate() {
        super.onCreate()
        analytics = Analytics(
            configuration = Configuration(
                writeKey = "WRITE_KEY",
                application = this,
                dataPlaneUrl = "DATA_PLANE_URL",
            )
        )
        
        analytics.add(AdjustIntegration())
    }
}

To add Adjust to your Android project, follow these steps:

Add mavenCentral() to the repositories section of your build.gradle file:

repositories {
  mavenCentral()
}

Next, add the following permissions to your AndroidManifest.xml file:

<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
// If you are not targeting the Google Play Store, you need to add the following permission:
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
// If you are targeting Android 13 and above (API level 33), you need to add the com.google.android.gms.AD_ID permission to read the device's advertising ID.
<uses-permission android:name="com.google.android.gms.permission.AD_ID"></uses-permission>

Finally, add the following lines in your build.gradle file under dependencies:

// RudderStack Android-SDK
implementation 'com.rudderstack.android.sdk:core:[1.0,2.0)'
// RudderStack Adjust-SDK
implementation 'com.rudderstack.android.integration:adjust:1.0.1'
// Add Google Play Services library to enable the Google Advertising ID for Adjust SDK
implementation 'com.google.android.gms:play-services-ads-identifier:17.0.1'
// To support the Google Play Referrer API, make sure you have the following in your build.gradle file:
implementation 'com.android.installreferrer:installreferrer:2.2'

For more information on implementing com.google.android.gms:play-services-ads-identifier:17.0.1, refer to the Adjust documentation.

After adding the dependency, register the RudderAdjustFactory with your RudderClient initialization as a factory of RudderConfig. Add the following line in your Application class:

import com.rudderstack.android.integration.adjust.AdjustIntegrationFactory;

Finally, change the SDK initialization to the following:

val rudderClient: RudderClient =
    RudderClient.getInstance(
        this,
        WRITE_KEY,
        RudderConfig.Builder()
            .withDataPlaneUrl(DATA_PLANE_URL)
            .withFactory(AdjustIntegrationFactory.FACTORY)
            .build()
    )

To add Adjust to your Unity app, follow these steps:

Add the RudderStack Unity SDK to your project.
Download the Adjust SDK extension package and import it in your project.

The package comes with Adjust Unity SDK embedded in it along with the required jar files for Android Install Referrer. It is strongly recommended to not add the Adjust SDK separately.

After importing the rudder-unity-extension-adjust.unitypackage to your project, attach the RudderPreferbs.prefab file from RudderUnityPlugin to your main GameObject.
Finally, change the SDK initialization:

// Build your config
RudderConfigBuilder configBuilder = new RudderConfigBuilder()
    .WithEndPointUrl(DATA_PLANE_URL)
    .WithFactory(RudderAdjustIntegrationFactory.GetFactory());

// Get instance for RudderClient
RudderClient rudderClient = RudderClient.GetInstance(
    WRITE_KEY,
    configBuilder.Build()
);

Follow the below steps to add Adjust to your Flutter Project:

Add the following dependency to the dependencies section of your pubspec.yaml file.

rudder_integration_adjust_flutter: ^1.0.1

Run the below command to install the dependency added in the above step:

flutter pub get

Import the RudderIntegrationAdjustFlutter in your application where you are initializing the SDK.

import 'package:rudder_integration_adjust_flutter/rudder_integration_adjust_flutter.dart';

Finally, change the initialization of your RudderClient as shown:

final RudderController rudderClient = RudderController.instance;
RudderConfigBuilder builder = RudderConfigBuilder();
builder.withFactory(RudderIntegrationAdjustFlutter());
rudderClient.initialize(<write_key>, config: builder.build(), options: null);

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.

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.

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 property	Adjust partner parameter
`revenue`	`price`
`quantity`	`quantity`

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"}
},

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

RudderStack’s Adjust mobile integration (iOS and Android) automatically triggers an Install Attributed event if you have enabled Install Attribution tracking in the dashboard settings.

The enhanced attribution support is available from:
Rudder-Adjust Android v2.1.0 and above
Rudder-Adjust iOS v2.2.0 and above

Usage

Follow these steps to use the enhanced attribution tracking feature:

1. Configure token mapping in the Adjust dashboard

In your Adjust dashboard, create a new event token specifically for the Install Attributed event — you can also use an existing event token in case you have one.
Copy the generated event token.
Use this token in the Adjust destination configuration (explained below).

2. Adjust destination configuration in RudderStack

In your RudderStack dashboard, add Adjust as a mobile device mode destination.
Specify your Adjust App Token.
In the Map events to Adjust event tokens dashboard setting, map the Install Attributed event to the event token obtained above.
Save the mapping.

3. Enable automatic attribution tracking

Toggle on the Enable Install Attribution dashboard setting to automatically track the Install Attributed event when the app is installed for the first time.

How attribution tracking works

By leveraging Adjust’s attribution callback on iOS and Android, the integration listens for an attribution change from Adjust’s SDK and triggers the event with the following Adjust attribution parameters:

Key	Value	Description
`provider`	`Adjust`	Hardcoded value
`trackerToken`	`attribution.trackerToken`	Token of the link to which the device is currently attributed
`trackerName`	`attribution.trackerName`	Name of the link to which the device is currently attributed
`campaign.source`	`attribution.network`	Name of the network to which the device is currently attributed
`campaign.name`	`attribution.campaign`	Name of the campaign to which the device is currently attributed
`campaign.content`	`attribution.clickLabel`	The click label tagged with the install
`campaign.adCreative`	`attribution.creative`	Name of the creative to which the device is currently attributed
`campaign.adGroup`	`attribution.adGroup`	Name of the ad group to which the device is currently attributed

An example of the attribution data automatically captured by the Install Attributed event is shown below:

{
  "event": "Install Attributed",
  "properties": {
    "provider": "Adjust",   // Always set to "Adjust"
    "trackerToken": "abc123",   // (NSString, null if unavailable)
    "trackerName": "Campaign Name",   // (NSString, null if unavailable)
    "campaign": {
      "source": "google",   // (NSString, null if unavailable)
      "name": "summer_campaign",   // (NSString, null if unavailable)
      "content": "click_label",   // (NSString, null if unavailable)
      "adCreative": "banner_ad",   // (NSString, null if unavailable)
      "adGroup": "mobile_users"   // (NSString, null if unavailable)
    }
  }
}

If any of the above values are unavailable, they are defaulted to null. This event is then sent to all the connected device mode and cloud destinations.

See the following FAQs for troubleshooting tips:

Why are the Install Attributed events not appearing in my Adjust dashboard?
Why is the Install Attributed event not triggering?

Adjust environment dependency on log level

RudderStack sends data to the Adjust environment depending on theLogger.LogLevel parameter set in the SDK, as listed in the table below:

`Logger.LogLevel`	Adjust environment
`VERBOSE` / `DEBUG` / `INFO` / `WARN` / `ERROR`	Sandbox
`NONE`	Production

RudderStack sends data to the Adjust environment depending on the RudderLogLevel set in the SDK, as listed in the below table:

`RudderLogLevel`	Adjust environment	Adjust SDK `LogLevel`
`DEBUG` / `VERBOSE`	Sandbox	`VERBOSE`
`NONE`/ `ERROR` / `WARN`/ `INFO`	Production	`ERROR`

For more information on RudderLogLevel, see the following SDK documentation:

FAQ

Where can I find the Adjust app token?

To get your Adjust app token, follow these steps:

Log into your Adjust dashboard.
Find your app and select the app options caret (^):

You will find your app token listed here.

How can I create a new event token in Adjust?

To create a new event token, follow these steps:

Log into your Adjust dashboard.
Find your app and select the app options caret (^):

Go to All Settings > Events:

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:

Log into your Adjust dashboard.
Find your app and select the app options caret (^):

Go to All Settings > Partner Setup > ADD PARTNERS:

Select the partner from the list and click the + option on the right to add.
Enter the relevant details to complete the configuration and click SAVE to complete the setup.

Why are the `Install Attributed` events not appearing in my Adjust dashboard?

Verify that the Adjust destination is correctly configured in your RudderStack dashboard.
Check your Adjust App Token is correctly specified in the dashboard configuration.
Make sure the Install Attributed event is properly mapped to the corresponding Adjust event token. See App install attribution section for more information.

Why is the `Install Attributed` event not triggering?

If you load Adjust’s SDK natively alongside the Rudder-Adjust integration, the Install Attributed event callback may not trigger correctly. You will need to remove the native Adjust implementation to avoid any conflicts.

If your device is already registered with Adjust, make sure to unregister it first, as attribution will not change for registered devices.

The device unregistration process is listed below:

This process is required because Adjust only triggers install attribution on the first genuine app installation for each device ID.

Find the device identifier:
- Get the IDFA (iOS) or Advertising ID (Android) from the raw view of an event in your RudderStack dashboard.
- Or check your device settings:
  - iOS: Settings > Privacy & Security > Apple Advertising > View Ad ID
  - Android: Settings > Google > Ads > View Ad ID
Uninstall app: Remove the app completely from your test device.
Unregister in Adjust Console:
- Go to Adjust Testing Console.
- Navigate to your app.
- Find and delete the IDFA (iOS) or Advertising ID (Android) from your registered test devices.
Clean reinstall:
- Reinstall the app on the device.
- Launch the app fresh — this should trigger the Install Attributed event.
- You should now see the device register in Adjust with a new Install Attributed event.

See the Adjust documentation for more information.

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

Questions? Contact us by Email or on Slack