Документация
Интеграция SDK

Параметры postback URL

Ниже представлено описание деталей поддержки postback в AppMetrica.

Общая информация

AppMetrica позволяет задавать postback для трекера и указывать в какой момент отправить postback. AppMetrica поддерживает postback об установке приложения (install postback) и postback о заданном событии в приложении (event postback), произошедшем после установки.

Применяются следующие правила:

  • Postback отправляется при появлении заданного события или атрибуции установки. Задержка при отправке составляет около 5 минут.
  • При получении HTTP-статуса 200 OK отправка считается успешной.
  • Если получен другой HTTP-стаутс, AppMetrica переотправляет postback в течении 24 часов. Переотправка производится каждые 5-10 минут.
  • Event postback посылается о событиях, произошедших не более чем через 6 месяцев после установки.

Передача параметров tracking URL

AppMetrica позволяет передавать любые параметры tracking URL в postback URL — укажите в postback URL имя параметра из tracking URL в фигурных скобках: {parameter_name}.

Например, в 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}

Список макросов postback URL

AppMetrica поддерживает список системных макросов, которые могут быть использованы в postback URL. Список содержит макросы для информации об устройстве, клике и приложении. Если AppMetrica не может определить значение параметра для макроса, то параметр будет пустым.

Информация об атрибутах клика

{click_id} — уникальный ID клика.

{match_type} — каким образом клик был ассоциирован с установкой. Возможные значения: [referrer, fingerprint, identifier].

{transaction_id} — идентификатор данного наступления события или установки. Например, если то же самое устройство генерирует то же самое событие, то transaction_id изменится.

{click_user_agent} — User-agent клика.

{click_datetime}UTC дата и время клика в формате RFC3339.

{click_timestamp} — время клика в формате UNIX timestamp в секундах.

{click_timezone} — временная зона клика в формате разницы с UTC в секундах.

{click_ipv6} — IP-адрес в момент клика в формате IPv6. Например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147.

{conversion_datetime} — UTC дата и время конверсии (события на устройстве) в формате RFC3339.

{conversion_timestamp} — время конверсии (события на устройстве) в формате UNIX timestamp в секундах.

{conversion_timezone} — временная зона (местоположения пользователя) для конверсии. В формате разницы с UTC в секундах.

{conversion_event_name} — имя события для учета конверсии.

{conversion_event_json} — вложенные атрибуты события в формате JSON.

{install_datetime} — UTC дата и время установки в формате RFC3339.

{install_timestamp} — время установки в формате UNIX timestamp в секундах.

{install_timezone} — временная зона (местоположения пользователя) для установки. В формате разницы с UTC в секундах.

{install_ipv6} — IP-адрес в момент установки в формате IPv6 (например, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147).

Информация об устройстве

{limit_ad_tracking} — ограничение трекинга рекламы на устройстве. Может принимать значения: 1 — если пользователь отключил идентификатор рекламы, 0 — если не отключил.

{google_aid} — Google AID устройства в формате, в котором получен с устройства.

{ios_ifa} — IFA устройства в формате, в котором получен с устройства.

{ios_ifv} — IFV для приложения в формате, в котором получен с устройства.

{windows_aid} — Windows AID в формате, в котором получен с устройства.

{device_manufacturer} — производитель устройства, определяется сервисом AppMetrica (например, Apple или Samsung).

{device_model} — модель устройства, определяется сервисом AppMetrica (например, Galaxy S6).

{device_type} — тип устройства, определяется сервисом AppMetrica. Возможные значения: [PHONE, TABLET, PHABLET, TV].

{device_locale} — язык устройства.

{os_name} — ios | android | windows.

{os_version} — версия операционной системы на устройстве пользователя.

Информация о приложении и операционной системе

{app_version_name} — версия приложения; в виде, как указана разработчиком.

{app_package_name} — имя пакета для Android или Bundle ID для iOS (например, ru.yandex.metro).