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

  1. 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.
  2. 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.

ParameterDescription
external_click_idAn 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_idAn 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.
Important:
When you redirect users to the Google Play Store, always pass the same value within the 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.....