Adjust can track installs from third-party stores using Android’s broadcast capabilities. or via a predefined tracker URL set in the Adjust SDK. Use either method to display these campaigns in your Adjust Dashboard reporting and automatically send callback data to any third-party store. Find out how to configure your app below.

Note: To track third-party installs using the Android referrer, your app release must contain the Adjust SDK version 4.12 or later.

Note: The following page contains examples using a minimum-length tracker token. Always use the entire tracker token as displayed in your Adjust Campaign Wizard.

1How to track third-party installs using the Android referrer

To track installs from third-party stores, you will need to make use of Android’s install_referrer intent. (This intent is also used by Google to notify the Adjust SDK of app installs from the Google Play Store). If the third-party store has configured this intent correctly, it will fire upon app install; all you need to do is ensure your app is listening for it.

Instruction for Adjust account owners

  1. Ensure your developer has configured the Adjust SDK’s broadcast receiver to receive the INSTALL_REFERRER intent
  2. Give the third party access to your Dashboard to create trackers or create and share your tracker URLs with them

Once you have implemented the INSTALL_REFERRER broadcast receiver and submitted your app and tracker URL to the third-party app store, Adjust will begin to receive install information and report it through your Adjust Dashboard. Your campaign structure data will be reported under the source and campaign information provided in the intent.

Instructions for third-party stores

Once you have have received the necessary tracker information from your client, you can configure your app store app as follows:

  1. Set up your store to know of app installs. This can be done in a number of ways and you can do it in whichever way you wish. Some example methods:
    • Subscribe to the broadcast receiver for an INSTALL_REFERRER
    • A third-party app if it is capable of detecting installs
  2. Set up a broadcast of an INSTALL_REFERRER intent (see here)

Once you have implemented the INSTALL_REFERRER, Adjust can receive install information and report it through the Adjust Dashboard. Adjust will also send callbacks for source and campaign information to any endpoint specified within the referrer (see the examples below).

1.1Required and additional parameters

Through the INSTALL_REFERRER intent, you pass Adjust key information so that we can categorize the attribution data appropriately. You are required to include the source of the install (adjust_store) and the Adjust tracker token. You can also include campaign information up to three sublevels deep (see the examples below).

Important notes for third-party stores and networks:

  • Any information following referrer= must be encoded
  • Any callback URLs included within the referrer must be double encoded
Required parameters
Parameter Value
utm_source adjust_store
adjust_tracker Adjust tracker token, e.g., abc123
Campaign parameters
Parameter Value
adjust_campaign campaign_name
adjust_adgroup adgroup_name
adjust_creative creative_name
Callback parameters
Parameter
adjust_install_callback
adjust_event_callback_123456
adjust_session_callback
adjust_rejected_install_callback
adjust_reattribution_callback

Example referrer intent

referrer=adjust_tracker%3Dabc123%26adjust_campaign%3DChristmasCamp59_ChristmasCampId330%26adjust_adgroup%3DAppId48399_SubID%26adjust_creative%3DCreative9383_SubId%26utm_source%3Dadjust_store&adjust_install_callback=www.3rdpartydomain.com%253Fsrc%253Dadjust%2526advertiserId%253D57638%2526password%253D4d13c4dc

Note: this referrer intent includes a callback, which is double encoded

2How to track third-party installs using a predefined tracker URL

You will first need to create a tracker URL in the Adjust Dashboard.

Instructions

  1. Navigate to your app and select your app options caret (^)
  2. Select Tracker URLs
  3. Select NEW TRACKER
  4. Enter a name for your tracker and select QUICK CREATE
  5. Copy your newly created tracker token (e.g., abc123) and pass it to your developer

2.1Developer instructions

Adjust tracking for pre-installed apps requires a specific APK version that automatically assigns installs to a predefined tracker URL, written directly into the Adjust SDK.

Adjust has developed a small ruby command line that allows you to quickly generate duplicate APKs with custom, pre-assigned tracker tokens. Once configured, the Adjust SDK will report all first app-opens (installs) with the preset tracker token, which Adjust will use for attributing users to your platform.

System Requirements:

  • ruby
  • apktool
  • jarsigner

Adjust SDK Requirements:

  • Android Version 4.11 or higher

Process Overview

  1. Verify System Requirements
  2. Identify the organic store tracker tokens as generated within the Adjust Dashboard
  3. Generate an adjust-config.yaml configuration file with settings for each third-party Android store. For full instructions, see here.
  4. Run the third-party store tracker tool
    • Once complete, the third-party store tracker tool will have generated an APK for your specific store/platform.

2.2Set up Adjust tracking for paid installs generated in third-party Android app stores

In order to track paid installs generated by third-party Android app stores, you do not need to use the third-party store tracker tool but can rather use a standard Adjust tracker URL.

2.3Testing Integration

To test that Adjust is properly tracking the partner version of your APK, follow the steps below:

  1. Operate an Android device that:
    • Does not have your app installed, and;
    • Has not been tracked by Adjust–in order for Adjust to track your test app launch as an install, all previously tracked app activity must be cleared from the Adjust system. To erase a device’s app history from the backend, use our Forget Device API. Instructions for accessing the Forget Device API are listed in the section below.
  2. Download the Partner APK with the hardcoded tracker token
  3. Open the app
  4. Check the Adjust Dashboard for an install tied to the hardcoded tracker token

Note: While all Adjust tracking is recorded in real time, it can take up to twenty minutes for your install to appear in your Adjust Dashboard.

2.4Clearing your Android device from Adjust

Conduct multiple tests on the same device with the Adjust Testing Console.