Параметры трекинг-ссылки
Ниже представлено описание структуры и параметров трекинг-ссылки AppMetrica.
Структура
https://[redirect|impression].appmetrica.yandex.com/serve/[tracking ID — идентификатор трекера]Домен redirect.appmetrica.yandex.com используется для атрибуции кликов, а impression.appmetrica.yandex.com — для показов.
Пример:
https://redirect.appmetrica.yandex.com/serve/1019409635088005254appmetrica.yandex.com — основной домен, который используется в данное время. Дополнительные возможные варианты:
- appmetrika.yandex.com
- appmetrica.yandex.ru
- appmetrika.yandex.ru
Трекинг-ссылка может содержать предопределенные параметры, которые необходимы для работы трекинга. Рекламная система (партнер AppMetrica) должна передавать определенные значения через эти параметры. Для упрощения этого процесса AppMetrica предоставляет макросы различных рекламных партнеров для подстановки в параметры. Например:
AppMetrica хранит macros-params соответствия для Партнера A:
-
click_id — {transaction_id} -
google_aid — {GAID}
Трекинг-ссылка полученная для Партнера A:
https://redirect.appmetrica.yandex.com/serve/1019409635088005254?click_id={transaction_id}&google_aid={GAID}Пользователю необходимо предоставить эту трекинг-ссылку Партнеру A. Трекинг начнет работать автоматически.
Параметры
Параметры разделены на категории: обязательные, рекомендованные, необязательные. Обратите внимание на дополнительные параметры для S2S вызова.
Обязательные
click_id={YOURMACRO}& — макрос для передачи уникального click ID. Используется для дедубликации.
Рекомендованные
Параметры для более точного учета установок.
google_aid={YOURMACRO}& — Google AID, в формате, как был получен с устройства.
google_aid_sha1={YOURMACRO}& — SHA1 хэш от Google AID.
google_aid_md5={YOURMACRO}& — MD5 хэш от Google AID.
ios_ifa={YOURMACRO}& — IFA в формате, как был получен с устройства.
ios_ifa_sha1={YOURMACRO}& — SHA1 хэш от IFA.
ios_ifa_md5={YOURMACRO}& — MD5 хэш от IFA.
oaid={YOURMACRO}& — Huawei OAID, в формате, как был получен с устройства.
oaid_sha1={YOURMACRO}& — SHA1 хэш от Huawei OAID.
oaid_md5={YOURMACRO}& — MD5 хэш от Huawei OAID.
windows_aid = {YOURMACRO}& — Windows AID в формате, как был получен с устройства.
windows_aid_sha1={YOURMACRO}& — SHA1 хэш от Windows AID.
windows_aid_md5={YOURMACRO}& — MD5 хэш от Windows AID.
Параметры для S2S вызова
device_ip={YOURMACRO}& — URL-encoded IP адрес устройства. Поддерживаются IPv4 и IPv6.
device_ua={YOURMACRO}& — URL-encoded User-Agent устройства.
click_timestamp={YOURMACRO}& — UTC timestamp клика в секундах.
noredirect={YOURMACRO}& — Cообщает в AppMetrica, что надо учесть клик, но не надо перенаправлять на магазин приложений. Значение по умолчанию равно 1.
Подробнее о s2s интеграции в разделе S2S интеграция.
Необязательные
Параметры для оптимизации кампаний. Переданные параметры отображаются в виде дерева в отчете Источники трафика.
afpub_id={YOURMACRO}& — ID аффилированного паблишера (суб-партнер).
site_id={YOURMACRO}& — ID конкретного рекламного места.
creative_id={YOURMACRO}& — ID конкретного баннера.
appmetrica_js_redirect=0& — отключает JavaScript-редирект.
Произвольные параметры
Для лучшей оптимизации кампании рекламодатель и рекламная сеть могут передавать дополнительные параметры в трекинг-ссылке.
Для передачи произвольных параметров добавьте их в трекинг-ссылку. Вы можете передавать значения через эти параметры несколькими способами:
Вручную — укажите значение параметра:
custom_parameter=value&Автоматически — используйте автоматические подстановки через макросы на стороне рекламной сети:
example_param={CUSTOM_MACRO}&
Все параметры, которые перечислены в трекинг-ссылке, будут представлены в отчете Источники трафика в виде дерева.
Примеры
Эти примеры вы можете использовать для тестирования — замените макросы на свои собственные. Удалите лишние, не поддерживаемые, необязательные параметры, если это необходимо.
- Android
-
https://redirect.appmetrica.yandex.com/serve/600573419754384676?click_id={transaction_id}&google_aid={google_aid}&afpub_id={affiliate_id}&custom_price={payout}Скопировано - iOS
-
https://redirect.appmetrica.yandex.com/serve/528515824760210044?click_id={transaction_id}&ios_ifa={ios_ifa}&afpub_id={affiliate_id}&custom_price={payout}Скопировано
Передача параметров в postback URL, deeplink и целевую ссылку
Чтобы передать значение параметра из tracking URL в postback URL, deeplink или в целевую ссылку, добавьте в их URL имя параметра в фигурных скобках: {custom_parameter}. Таким образом могут быть переданы любые параметры — произвольные и предопределенные.
Примеры передачи параметров:
- В целевую ссылку
-
Чтобы добавить макрос для передачи, достаточно отредактировать целевую ссылку в настройках трекера:
Например, в tracking URL передаются следующие параметры:
https://redirect.appmetrica.yandex.com/serve/123456?custom_parameter=value1&another_param=value2Чтобы передать параметры
value1иvalue2в целевой ссылке, следует написать:https://endpoint.myadnetwork.com?some_parameter={custom_parameter}&another_param={another_param} - В postback URL
-
Чтобы добавить макрос для передачи, достаточно отредактировать postback URL в настройках трекера:
Например, в tracking URL передаются следующие параметры:
https://redirect.appmetrica.yandex.com/serve/123456?custom_parameter=value1&another_param=value2Чтобы передать параметры
value1иvalue2в postback URL следует написать:https://endpoint.myadnetwork.com?some_parameter={custom_parameter}&another_param={another_param} - В deeplink
- Передача параметров из трекинг-ссылки в deeplink происходит по следующей схеме:
Чтобы добавить макрос для передачи, достаточно отредактировать deeplink в настройках трекера:
Например, в tracking URL передаются следующие параметры:
https://redirect.appmetrica.yandex.com/serve/123456?custom_parameter=value1&another_param=value2Чтобы передать параметры
value1иvalue2в deeplink следует написать:myscheme://custom_parameter={custom_parameter}&another_param={another_param}