Overview

Adjust is a mobile measurement partner used by marketers to primarily track and attribute events in their mobile app to their advertising activities. This helps them measure performance of their marketing campaigns. Eg: Installs of your mobile app driven by a certain Facebook ad campaign would be reported by Adjust if that's your mobile measurement partner. The integration on Clarisights for Adjust makes use of the Adjust KPI Service and fetches aggregated data only.

Being a native analytics integration on Clarisights, one of the most sought after features is that the data from adjust will be joined directly to the ad channels' objects. For eg: Facebook campaigns that are driving app installs measured in adjust would have the metrics joined to the campaign itself and can be visualised using the metrics prefixed with "AJ-". To know more about this refer to secondary data in Clarisights here.

  • API Token

    You'll find this in the "My Profile" section of your Adjust dashboard. You'll need this to create your user on Clarisights for the apps to be grouped under.

  • App Tokens

    You'll find your app tokens as part of the URL of the dashboard for each app. It's the string between default/ and ?timezone_id You'll need this to connect the apps on Clarisights.

Once you have these credentials you can head over to the Integrations page and onto the Card for adjust and click +User or +Connect and enter your name or email id and your API Token. If you've already added your user and only want to connect new apps then you may skip this step.

After the user is created you will see a new section in the same page with your name or email with no apps under it. Click on the +App button to add an app that you have access to on Adjust.

  • Enter the name of the App as you want to be visible on Clarisights

  • The app token from Adjust

  • The currency that your Adjust dashboard reports on

  • Timezone that you wish to see the data in Clarisights

Note: The currency and timezone once set cannot be changed dynamically. Changing it requires to be followed with a backfill to correct the historical data according to the new configurations. Reach out to your Clarisights CSM to know more if you run into this situation.

Data model & mappings

The data from adjust comes the following hierarchy of trackers

→ Network Tracker

→ Campaign / 1st Sub-Network Level Tracker

→ Adgroup / 2nd Sub-Network Level Tracker

→ Creative / 3rd Sub-Network Level Tracker

Once the apps are connected you can head over to the mapping section, click on Connected Networks button to declare which Network trackers on Adjust correspond to which Advertising Channels on Clarisights so the system can attempt to join the metrics to the ad objects in the relevant advertising channels on Clarisights.

Here you will find the list of advertising channels on Clarisights and the Adjust network trackers under them when you expand the row. Some mappings are default and provided by Adjust already which you'll find pre-populated here.

To map a new tracker name to an ad channel on Clarisights click on +Network and enter the network tracker name in the "value" field and select which ad channel on Clarisights the data for that network tracker Clarisights should attempt to join the Adjust metrics to. You will find the list of API Advertising channels as well as Custom Advertising channels. Do keep in mind to update the map on Clarisights if you create new tracker names on Adjust.

Note: You can find the tracker names on the Deliverables section of your adjust dashboard. The top most level of data is the Network tracker level. If a tracker-ad channel map is not provided then Clarisights cannot join that data at all and will not be visible on Clarisights.

How Adjust data is joined to the Advertising data on Clarisights

The data from adjust is joined to the primary data from the connected advertising channels on Clarisights on the basis of the Ad Object name and/or ID. Eg: Campaign Name, Campaign ID, Ad Name, Ad ID, etc. The system looks up the ad object data provided by Adjust and tries to find the same ad object in the relevant ad channel connected to Clarisights to join the datasets.

1. In case of API Advertising Channels

Typically the Campaign, Sub-Campaign and Creative field values from Adjust are in the format of Ad Object Name<space>(Ad Object ID). Eg: Campaign Name (Campaign ID) where the ID may or may not be available.

This is the default format Clarisights supports and will attempt to find the ad object name or the ad object ID in the mapped channel for that tracker name. If the object is found then the metrics will be directly joined to the ad object in the respective channel. You will be able to see this as a single row in your widgets when using the relevant dimension and adjust metrics.

In case of some networks the data is not in this standard format and can depend on what is being passed when the adjust tracking links are created. In such cases it is crucial to ensure the tracking links passed have the ad object name and/or the ID in a dependable pattern (also known as a regular expression). As long as you have a dependable pattern that can fit into a regular expression, Clarisights can use that pattern to configure the regular expression and determine the ad object name or the ID to use to find the right object in the Ad Channel and join the adjust data to the object.

Eg: If the tracking links you generate for your TikTok campaigns are in the format of Campaign Name<ampersand>Campaign ID it can be configured to use a regular expression to determine the Campaign Name and Campaign ID for the purpose of joining. For this kind of custom joining rules reach out to your Clarisights CSM or write to support@clarisights.com.

Currently we support native adjust joining to the following API Advertising Channels

  • TikTok Ads

  • Google Ads

  • Facebook Ads

  • Remerge

  • Twitter

  • Snapchat

  • Apple Search Ads

  • Criteo

2. In case of Custom Advertising Channels

When you have Custom Advertising channels set up on Clarisights and are importing only certain dimensions, it becomes crucial to ensure the hierarchy is the same on both the Advertising Channel side as well as the tracker setup on Adjust.

EG: for Liftoff advertising data you can setup a Custom Advertising channel with the following hierarchy

Account —> Campaign —> AdGroup (no data) —>AdCreative

If your Adjust data is also in the similar hierarchy then you can setup custom rules to join the data assuming the ad object names and / or IDs are the same on both sides.

Network —> Campaign —> Publisher —> Ad Creative

Similar to the case with API Integration channels, as long as you have a dependable pattern that can fit into a regular expression, Clarisights can use that pattern to configure the regular expression and determine the ad object name or the ID to use to find the right object in the Ad Channel and join the adjust data to the object.

Eg: If the tracking links you generate for your Liftoff campaigns are in the format of Campaign Name<&>Campaign ID it can be configured to use a regular expression to determine the Campaign Name and Campaign ID for the purpose of joining. For this kind of custom joining rules reach out to your Clarisights CSM or write to support@clarisights.com.

What metrics are available from Adjust?

There are 4 types of metrics that Clarisights fetches from Adjust that are available via the Adjust KPI service

  1. App KPIs

    These are common across all apps and do not need to be configured. The metrics include Installs, Uninstalls, Reinstalls, Sessions, Clicks, Revenue, DAUS, WAUS, MAUS, Limit Ad Tracking Installs, Limit Ad Tracking Reattributions.

  2. Event KPIs

    These metrics are number of times various configured events were triggered in a certain date range. On Clarisights you have the option to define which event metrics you'd want to fetch to use in the workspace.

    Head over to the Integrations page for Adjust on Clarisights and click on the +Add Events button next to the app for which you'd like to integrate events. Select the available events that you'd like to import, select the format type and currency type by clicking the relevant checkboxes and click on +Add Events to integrate those events.

    Pro Tip: If you have multiple different event names across apps for the same class of events, consider renaming those event names on Adjust to unify the names across apps. Eg: App A has the primary conversion event called Purchase and App B has the primary conversion event called Purchase Complete, if they mean the same you can rename them on Adjust so that the columns blend on Clarisights.

  3. Cohort KPIs

    Cohorts let you isolate users who installed and/or were reattributed to your app within a certain timeframe. You can use cohorts to trace changes in user behavior from the time of installation of the app. On Clarisights you can fetch the number of events triggered in a certain timeframe since the date of the installation. The timeframes supported are 0d, 1d, 2d, 3d, 4d, 5d, 6d, 0w, 0m. Contact your Clarisights CSM or write to support@clarisights.com to enable or disable specific cohort window metrics for your events. These cohort metrics are prefixed with "AJ-C:" Eg: AJ-C: Transaction Completed (0w)

  4. SKAN KPIs

    Since iOS 14.5 and Apple's ATT, conversions for campaigns targeting iOS 14.5 and higher are reported by Apple's SKAdNetwork. This data is shared with Adjust from the various ad partners and is made available in Clarisights. These metrics are prefixed with "AJ-SKAN:" The metrics available are Installs, Reinstalls, Conversions 1-6, Invalid Payloads, Valid Conversions.

    For more information refer to this article on Adjust SKAN data.

Known limitations

Did this answer your question?