Third-party app store tracking
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.

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.

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.

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).

Required 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

ParameterValue
utm_sourceadjust_store
adjust_trackerAdjust tracker token, e.g., abc123 

Note: This example is a minimum-length tracker token. Always use the entire tracker token as displayed in your Adjust Campaign Wizard.

Campaign parameters

ParameterValue
adjust_campaigncampaign_name
adjust_adgroupadgroup_name
adjust_creativecreative_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

Track third-party installs using a predefined tracker URL

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

Instructions

In the Adjust dashboard

  1. Navigate to your app and select your app options caret (^)
  2. Select Tracker URLs
  3. Navigate to the bottom of the window and select NEW TRACKER
  4. Type the desired name of your new Adjust tracker URL, then select CREATE
  5. Retrieve the Adjust tracker token(s) for your organic store tracker URL(s) to submit to your Android developer for integration

Developer 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 uses for attributing your users. 

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 adjust-config.yaml configuration file with settings for each third-party Android store—full instructions here.
  4. Run the store and pre-install tracker tool
Once complete, the store and pre-install tracker tool will generate an APK for your specific store/platform, allowing Adjust to track app installs for each APK, individually. 

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

You do not need to use the store and pre-install tracker tool to track paid installs generated by third-party Android app stores. Instead, you can use the standard Adjust tracker URL.

Testing 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 clearing a device can be found on our Adjust Testing Console page.
  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. If you want to conduct multiple tests on the same device you must clear your device between tests.

On this topic