S2S integration
A number of advertising networks support "server-to-server" (S2S) integration with AppMetrica. With S2S integration, ad traffic is redirected directly to the app store. In that case, the advertising network records the "impression" or "click" by calling the tracking link. This call comes from the advertising network's server.
Note
The attribution includes impressions and clicks sent to AppMetrica no later than 12 hours after the event.
Sending the user directly to the app store (without an additional redirect) sometimes improves the conversion rate.
For tracking to work correctly when using this method, the advertising network must make the transition using the tracking link, as the user's browser would have. To transmit data needed for app install attribution to the tracking URL/impression URL and the resulting landing page, add the parameters listed below.
To the tracking URL/impression URL
|
Parameter |
Required |
Example |
Description |
|
|
Yes |
device_ip=192.0.2.0/24 |
URL-encoded IP address of the user's device. IPv4 and IPv6 are supported |
|
|
Yes |
device_ua=... |
URL-encoded User-Agent on the user's device |
|
|
Yes |
click_timestamp=1453895044 |
UTC timestamp of the click, in seconds |
|
|
No |
noredirect=1 |
Notifies AppMetrica that the click should be counted without redirection to the app store. The default value is 1 |
|
|
No |
click_id=123456789 |
Unique click ID. Also enables the correct operation of InstallReferrer |
|
|
No |
google-aid=8e4dd44b-82ec-43d0-a5de-321...... |
Google AID, exactly as received from the device |
|
|
No |
idfa=30255BCE-4CDA-4F62–91DC-475.......... |
IFA, exactly as received from the device |
|
|
No |
oaid=1fe9a970-efbb-29e0-0bdd-f5.......... |
Huawei OAID, exactly as received from the device |
You can use the additional parameters for device identification.
To the resulting landing page
Pass the referrer parameter with the pair of values appmetrica_click_id={click_id}
Example:
play.google.com/store/apps/details?hl=ru&gl=ru&id=com.non.noncalendar&referrer=appmetrica_click_id%3D123456789
Note
For correct InstallReferrer attribution, pass click_id both in the destination URL and in the GET request. To do this, we recommend implementing the following method of data transfer.
Example
Parameter in the referrer:
play.google.com/store/apps/details?hl=ru&gl=ru&id=com.non.noncalendar&referrer=appmetrica_click_id%3D123456789
Parameter in the GET request:
GET redirect.appmetrica.yandex.com/serve/TRACKING_ID?click_id=123456789&device_ip=192.0.2.0/24&device_ua=Mozilla/5.0%20
(Linux;%20Android%204.4.4;%205042D%20Build/KTU84P)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Version/4.0%20Chrome/33.0.0.0%20Mobile%20Safari/537.36&click_timestamp=1453895044&noredirect
Sample request
For clicks:
GET redirect.appmetrica.yandex.com/serve/TRACKING_ID?click_id=123456789&device_ip=192.0.2.0/24&device_ua=Mozilla/5.0%20 (Linux;%20Android%204.4.4;%205042D%20Build/KTU84P)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Version/4.0%20Chrome/33.0.0.0%20Mobile%20Safari/537.36&click_timestamp=1453895044&noredirectwhere
TRACKING_IDis the ID of the tracker in AppMetrica (present in the user's tracking URL).For impressions:
GET impression.appmetrica.yandex.com/serve/TRACKING_ID?click_id=123456789&device_ip=192.0.2.0/24&device_ua=Mozilla/5.0%20 (Linux;%20Android%204.4.4;%205042D%20Build/KTU84P)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Version/4.0%20Chrome/33.0.0.0%20Mobile%20Safari/537.36&click_timestamp=1453895044&noredirectWhere
TRACKING_IDis the ID of the tracker in AppMetrica (part of the user's tracking URL).The HTTP response code from AppMetrica for requests in those cases is 204 No Content.
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.