Tracking pre-installed Android apps for networks
There are different ways to help your Adjust clients track the success of their pre-installed apps on Android.
Here, you'll learn what you need to keep in mind when setting up pre-install tracking and building successful pre-install callbacks. If you have any questions, please contact integration@adjust.com.
Before you begin
Here's what you need to know before getting started.
Requirements
- Your client's pre-install tracker token(s).
- The ability to redirect users with customized referrer information.
Set up pre-install tracking
To run Adjust-tracked pre-install campaigns, follow these steps.
- Get the tracker token provided by the client.
- Example:
https://app.adjust.com/abc123
whereabc123
is the tracker token. Tracker tokens may be six to eight characters long; always use the full tracker token.
- Example:
- Format the referrer value using the required parameters.
- Include the source of the install (either
adjust_store
oradjust_preinstall
) and your client's Adjust tracker token(s). - Append any additional parameters to receive further campaign information.
- Include the source of the install (either
- Redirect the user to the Google Play Store with the newly set up referrer.
referrer=
. Double encode any callback URLs included with the referrer.
Example referrer
Parameters required for referrer
Parameter | Value |
utm_source | adjust_preinstall or adjust_store (these are interchangeable) |
adjust_tracker | Advertiser's Adjust tracker token |
Campaign parameters
You can include campaign information up to three sub-levels deep. We use the parameters shown below to report your campaign structure data.
To receive campaign information at the campaign, creative, or adgroup level, use these parameters.
Parameter | Value |
adjust_campaign | campaign_name |
adjust_adgroup | adgroup_name |
adjust_creative | creative_name |
Set up callbacks
Adjust lets you attach callback URLs directly to tracker URLs. This automatically fires a callback to your endpoint upon conversion. Use our Adjust Tracker Encoding Tool to make sure your formatting is correct.
To track installs, events, sessions, rejected installs and reattributions in your clients' pre-install campaigns, use the campaign parameters in the chart below.
Note: if you include callback URLs with the referrer, make sure to double encode them.
Callback parameters
Parameter |
adjust_install_callback |
adjust_event_callback_123456 |
adjust_session_callback |
adjust_rejected_install_callback |
adjust_reattribution_callback |
Example referrer with callback appended
This example 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%26adjust_install_callback%3Dwww.3rdpartydomain.com%253Fsrc%253Dadjust%2526advertiserId%253D57638%2526password%253D4d13c4dc