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 broadcast an
INSTALL_REFERRER
intent
Set up pre-install tracking
To run Adjust-tracked pre-install campaigns, follow these steps.
- Use the tracker token provided by the client
- Example:
https://app.adjust.com/abc123
whereabc123
is the tracker token (tracker tokens may be six or seven characters long; always use the full tracker token)
- Example:
- Format the
INSTALL_REFERRER
referrer value using the required parameters- Include the source of the install (either adjust_store or adjust_preinstall) and your client's Adjust tracker token(s)
- You can include campaign information up to three sublevels deep (we use the parameters in the chart below to report your campaign structure data). To receive campaign information at the campaign, creative, or adgroup level, use the parameters in the chart below.
- Broadcast the
INSTALL_REFERRER
intent with your new referrer after the app finishes installing on the user's device.
Note: Encode any information that follows referrer=. Double encode any callback URLs included with the referrer.
Parameters required for the INSTALL_REFERRER
Parameter | Value |
utm_source | adjust_preinstall or adjust_store (these are interchangeable) |
adjust_tracker | Adjust tracker token, for example abc123 Note: This is a minimum-length tracker token. Always use the entire tracker token displayed in your Adjust dashboard. |
Campaign 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 Tracker URL Generator 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 intent (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