Assign a name to the destination and click Continue.
To successfully configure Adjust as a destination, you will need to configure the following settings:
APP Token: Enter your Adjust app token. For more information on obtaining your Adjust app token, refer to the FAQ section below.
Send to Production Environment on Adjust: Enable this setting 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. This setting is applicable only when sending events to Adjust via device mode. For more information, refer to the Client-side Events Filtering guide.
Map events to Adjust Event Tokens: This setting lets you map the RudderStack events to Adjust’s event tokens. For more information on creating an event token in Adjust, refer to the FAQ section below.
RudderStack Parameters to Partner Parameters: This setting lets you map your event properties to specific Adjust partner parameters.
Delay Time before SDK initialization: This setting is applicable only for sending events via device mode. You can use it to initiate a delay in loading the SDK for the first time. For more information, refer to the Adjust documentation.
Use device mode to send events: Enable this setting for the Android/iOS SDK to send events to Adjust via device mode.
Do not add native Adjust SDK to your project as it will prevent you from integrating it successfully.
Add a 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:
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:
Then, change the SDK initialization to the following:
To add Adjust to your Android project, follow these steps:
Add mavenCentral() to the repositories section of your build.gradle file:
Next, add the following permissions to your AndroidManifest.xml file:
<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:
// 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.
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:
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:
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 configRudderConfigBuilderconfigBuilder=newRudderConfigBuilder().WithEndPointUrl(DATA_PLANE_URL).WithFactory(RudderAdjustIntegrationFactory.GetFactory());// Get instance for RudderClientRudderClientrudderClient=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.
Run the below command to install the dependency added in the above step:
Import the RudderIntegrationAdjustFlutter in your application where you are initializing the SDK.
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.
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.
For more information on adding a partner in Adjust, refer to the FAQ section below.
Make sure you have defined the property mapping in the RudderStack Parameters to Partner Parameters dashboard setting. Adjust will reject any properties apart from these mappings.
RudderStack uses the property mappings specified in the RudderStack Parameters to Partner Parameters setting to check if a key is present in the track event properties and maps it to the corresponding Adjust partner parameter object.
The partner parameters only accept the String data type.
Suppose a customer sets the following mapping in the RudderStack dashboard:
Adjust partner parameter
A sample track call with the above properties is shown below:
cookies, the cookies that are categorized as necessary are stored on your browser as they are as
for the working of basic functionalities of the website. We also use third-party cookies that
analyze and understand how you use this website. These cookies will be stored in your browser
consent. You also have the option to opt-out of these cookies. But opting out of some of these
have an effect on your browsing experience.
Necessary cookies are absolutely essential for the website to function properly. This
category only includes cookies that ensures basic functionalities and security
features of the website. These cookies do not store any personal information.
learn more about cookies and why we use them, visit our cookie
policy. We'll assume you're ok with this, but you can opt-out if you wish Cookie Settings.