Measure installs with Google Play install referrer
To measure installs from third-party stores, you can use the Google Play Install Referrer API on Android. This API notifies the Adjust SDK of app installs from the Google Play Store. When the third-party store has configured the engagement information into the Google referrer correctly, it fires upon app install. Then, you use the Google Play Referrer API to retrieve referral content.
Steps for Adjust account owners
- Set up support for the Google Play Install Referrer API in the Adjust SDK.
- Create a link for your partner or a custom link and share it with the third-party store.
Now, Adjust can begin to receive install information. Your data is available in Datascape, with the campaign structure reporting under the source and campaign information provided in the install referrer.
Steps for third-party stores
Once you have have received the necessary information from your client, configure your app store app as follows:
- Set up engagement information in the Google Play Install Referrer API, before app install.
- Append required parameters and any additional parameters.
Parameters
Through the Google Play Install Referrer API, you pass key information to Adjust so that we can categorize attribution data appropriately. You need to include the source of the install (adjust_store) and the Adjust link token. You can also include campaign information up to three sublevels.
Required parameters
| Parameter | Value |
|---|---|
utm_source | adjust_store |
adjust_tracker | Adjust link token, e.g., abc123 Note: This example is a minimum-length link token. Always use the entire link token as displayed for your link in Campaign Lab. |
Additional campaign parameters
| Parameter | Value |
|---|---|
adjust_campaign | campaign_name |
adjust_adgroup | adgroup_name |
adjust_creative | creative_name |
Additional callback parameters
| Parameter |
|---|
adjust_install_callback |
adjust_event_callback_123456 |
adjust_session_callback |
adjust_rejected_install_callback |
adjust_reattribution_callback |
Once you have implemented the install referrer, Adjust can receive install information and report it in Datascape. Adjust will also send callbacks for source and campaign information to any endpoint specified within the referrer (see the example below).
This example referrer value includes a callback, which is double encoded.
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