Параметры 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 не может определить значение параметра для макроса, то параметр будет пустым.

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

{adwords_link_id} — ID связи Google Ads и AppMetrica. Подробнее в разделе Настройка трекинга кампаний Google Ads.

{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).