Overview

Adjust is an analytics platform that provides marketers with attribution information to derive business intelligence and grow their mobile apps. This document provides information about integrating Adjust and CleverTap. This integration helps track the following information from Adjust:

  • Install events: These events can be organic install events and inorganic install events.
  • Custom data: These events can include any events (other than install events) that are provided by the attribution partner and tracked in the app. The following events are tracked for Adjust: In-app revenue, In-app events, and any other custom events that you may want to track.

To learn more about these events and their default attribution settings in the CleverTap dashboard, refer to Types of Data.

Integrate Adjust

To enable Adjust integration with the CleverTap dashboard, proceed as follows:

  1. Add CleverTap Credentials to Adjust dashboard.
    To activate integration with CleverTap from Adjust dashboard, follow the steps listed under Setup CleverTap in Adjust documentation.
  2. Integrate Adjust.
  3. Setup for Organic Install and Custom Events.

Integrate Adjust

Adjust SDK's implementation requires clevertapId configured as a custom partner parameter.

🚧

Warning

Events without the 'clevertapId' parameter are not processed.

The integration steps vary for Android and iOS. The steps for both are listed below.

For Android App

  1. To track attribution and events data in your Android app, perform the steps listed in Adjust Android SDK Integration Guide.
  2. Set the value of 'clevertapId' as an Adjust partner parameter. To do so, add the following code to your Android app code. For more information about partner parameters, click here.

For SDK version 4.2.0 and above

The getCleverTapAttributionIdentifier method is deprecated for CleverTap Android SDKs version 4.2.0 and above. Use the new getCleverTapID method to get the CleverTap ID on the OnInitCleverTapIDListener to set CustomerUserId method of Adjust.

cleverTapInstance.getCleverTapID(new OnInitCleverTapIDListener() {
   @Override
   public void onInitCleverTapID(final String cleverTapID) {
       // Callback on main thread
       Adjust.addSessionPartnerParameter("clevertapId", cleverTapID);
   }   
});

For SDK version 4.1.1 and below

String attributionID = cleverTapInstance.getCleverTapAttributionIdentifier();
Adjust.addSessionPartnerParameter("clevertapId", attributionID);

For iOS App

  1. To track attribution and events data in your iOS app, perform the steps listed in Adjust iOS SDK Integration Guide.
  2. Update your app delegate’s interface declaration to include the AdjustDelegate protocol. To do so, add the following code to your iOS app code. For more information about partner parameters, click here.

Update your application:didFinishLaunchingWithOptions: to set the Adjust delegate.

- (BOOL) application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *) launchOptions {
    ...
    NSString *yourAppToken = @"{ADJUST_APP_TOKEN}";
    NSString *environment = ADJEnvironmentProduction;
    ADJConfig *adjustConfig = [ADJConfig configWithAppToken:yourAppToken
                                                environment:environment];

    [adjustConfig setDelegate:self];
    [Adjust appDidLaunch:adjustConfig];
    ...
    return YES;
}

Setup Session Callback Parameters

[CleverTap autoIntegrate];
[Adjust addSessionPartnerParameter:@"clevertapId" value:[[CleverTap sharedInstance] profileGetCleverTapAttributionIdentifier]];

For React-Native App

To integrate Adjust with CleverTap for the react native app, add the following code to your React-Native app code:

CleverTap.getCleverTapID((err, res) => {
          Adjust.addSessionPartnerParameter("clevertapId",res);
        });

Setup for Organic Install and Custom Events

After completing the above steps, Adjust starts pushing inorganic install events data to CleverTap. To receive additional events such as organic install events, in-app revenue, custom data, or in-app events in CleverTap from Adjust, proceed as follows:

  1. Navigate to Settings > Partners and scroll down to the Attribution partners section.
2868

CleverTap Attribution Partners

  1. Click the Edit icon against the Adjust partner.
    The Attribution partner - Adjust window opens on the right side of the screen.
2440

Attribution Partner-Adjust

  1. Select the required option from the following available options. Selecting any of these options indicates that the CleverTap accepts event data when shared by the partner.
    • Custom events
    • Organic install events

🚧

Duplication of Events

If you select Organic install events for more than one attribution partner, a warning for duplication of events displays, as shown in the following figure. We strongly recommend tracking the organic install events from only one attribution partner.

1128

Duplication of Events

  1. Click Save. On clicking, the following message displays at the top of the screen: Changes saved. Admins are notified of this via email.

Viewing Data in Dashboard

You can now view the event data on the CleverTap dashboard. To do so, proceed as follows:

  1. From the CleverTap dashboard, navigate to Analytics > Events.
  2. Apply the required filters for the selected event. The filters vary depending on the type of event.
    on_ For Install Events: All the install events are tracked under the _UTM Visited* event.
1640

Apply Event Filters

To further filter events by organic or inorganic events, you can use the event property is_organic, where is_organic = 1 indicates that the event is an inorganic install event and is_organic = 0 indicates that the event is an organic install event.

  • For Custom Events: In-app revenue, Custom data, and In-app events received from Adjust are prefixed with AD in CleverTap.