We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

for Partners

Pre-installed Android app measurement for networks

There are different ways to help your Adjust clients measure 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 measurement 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 link token(s).
The ability to redirect users with customized referrer information.

Set up pre-install measurement

To run pre-install campaigns that Adjust can measure, follow these steps.

Get the link token provided by the client.
- Example: https://app.adjust.com/abc1234 where abc1234 is the link token. Link tokens may be six to eight characters long; always use the full link token.
Format the referrer value using the required parameters.
- Include the source of the install (either adjust_store or adjust_preinstall) and your client's Adjust link token(s).
- Append any additional parameters to receive further campaign information.
Redirect the user to the Google Play Store with the newly set up referrer.

Important:

Encode any information that follows referrer=. Double encode any callback URLs included with the referrer.

Example referrer

Encoded

Unencoded

referrer=adjust_tracker%3Dabc123%26adjust_campaign%3DChristmasCamp59_ChristmasCampId330%26adjust_adgroup%3DAppId48399_SubID%26adjust_creative%3DCreative9383_SubId%26utm_source%3Dadjust_store%26

Parameters required for referrer

Parameter	Value
utm_source	`adjust_preinstall` or `adjust_store` (these are interchangeable)
adjust_tracker	Advertiser's Adjust link 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, adgroup, or creative 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 link URLs. This automatically fires a callback to your server endpoint upon conversion. Use our Adjust Encoding Tool to make sure your formatting is correct.

To measure installs, events, sessions, rejected installs and reattributions in your clients' pre-install campaigns, use the campaign parameters in the chart below.

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