Record S2S clicks with a referrer
If you are running Android campaigns and do not have access to advertising IDs on click engagements, you can send server-to-server clicks with the Adjust external_click_id
parameter. This lets Adjust match the click ID we receive with that sent to Google using the Install Referrer API.
How it works
- When a user downloads, installs, and opens an Android app for the first time, the Adjust SDK receives this referrer information using the Install Referrer API and sends it to the Adjust backend.
- There, we match the referrer value received by the Play Store at install with the value sent to Adjust upon click engagement in the
external_click_id
parameter.
Implementation
Always include the following parameters in your requests to Adjust and the Google Play Store.
Parameter | Description |
---|---|
external_click_id | An Adjust parameter you use to pass a click ID value to Adjust. We use this to match an install to a click. Use this parameter in your requests to Adjust. |
adjust_external_click_id | An Adjust parameter you use to populate the referrer parameter that is appended to the Google Play Store URL.This parameter is populated by a click ID value. |
referrer
parameter as you send to Adjust with the external_click_id
. This lets us match the values for attribution.
S2S click request to Adjust
Use the external_click_id
parameter in your S2S request to Adjust. Populate the {click_id}
with your own network macro.
Here's an example of the format you can use to send an S2S click request to Adjust:
https://s2s.adjust.com/abc123?campaign={campaign_id}&adgroup={publisher_id}&creative={creative_id}&external_click_id=your_network_{click_id}&s2s=1
S2S click request to Google Play Store
On the Play Store URL you use to redirect users to the store and download the app, append the Google Play referrer
parameter. Populate this parameter with the Adjust external click ID parameter: adjust_external_click_id
. Make sure that everything within the referrer parameter is encoded. Populate the {click_id}
with your own network macro.
Here's an example of the format you can use to send Google Play Store a click request:
https://play.google.com/store/apps/details?id=my.app.id&referrer=adjust_external_click_id%3Dyour_network_{click_id}%26.....