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 where abc123 is the tracker token (tracker tokens may be six or seven characters long; always use the full tracker token)
  • 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

ParameterValue
utm_sourceadjust_preinstall or adjust_store (these are interchangeable)
adjust_trackerAdjust 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

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

 


 

On this topic