Параметры postback

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

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

AppMetrica позволяет задавать postback для трекера и указывать, в какой момент отправить postback. AppMetrica поддерживает:

  • postback об установке приложения (install postback);
  • postback о заданном событии в приложении, произошедшем после установки (event postback);
  • postback при получении из приложения ecommerce-события (ecommerce postback);
  • postback при получении из приложения события об inapp-покупках (purchase postback);
  • postback при получении из приложения события о показе рекламы (adrevenue postback).

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

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

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

AppMetrica позволяет передавать любые параметры tracking URL в постбэке — укажите в postback URL или postback body (для метода POST) имя параметра из 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}

Для передачи параметров value1 и value2 методом POST в body следует написать:

{
  "some_parameter": "{custom_parameter}",
  "another_param": "{another_param}"
}

Список макросов для postback

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

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

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

{click_id} — уникальный ID клика/показа. Макрос недоступен для неатрибуцированных постбеков.

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

{attributed_touch_type} — тип рекламного взаимодействия. Возможные значения: click | impression.

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

{start_datetime} — UTC дата и время старта сессии в формате RFC3339.

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

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

{session_id} — идентификатор сессии. Уникален только в пределах конкретного приложения, appmetrica_device_id, конкретной установки и типа сессии (foreground/background).

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

{adwords_rdid} — Google AID для Android или IFA для iOS. Если Google AID или IFA отсутствуют — передается "00000000-0000-0000-0000-000000000000".

{appmetrica_device_id} — уникальный идентификатор устройства, который устанавливает AppMetrica.

{profile_id} — идентификатор профиля. Подробнее в разделе Профиль пользователя.

{limit_ad_tracking} — ограничение трекинга рекламы на устройстве. Может принимать значения: 1 — если пользователь отключил идентификатор рекламы, 0 — если не отключил. Если на устройстве доступно несколько идентификаторов (например, Google AID и Huawei OAID), то принимает значение 0, если доступен хотя бы один.

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

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

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

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

{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} — версия операционной системы на устройстве пользователя.

{operator_name} — имя оператора сотовой связи.

{mcc} — мобильный код страны.

{mnc} — код мобильной сети.

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

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

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

{appmetrica_sdk_version} — версия библиотеки AppMetrica, которая была интегрирована в приложение.

{store_app_id} — идентификатор приложения в Google Play или App Store.

Макросы для ad revenue событий

{price} — доход от показа.

{currency} — валюта дохода от показа.

Макросы для любых покупок

{price} — цена покупки или товара.

{currency} — валюта покупки.

{product_id}product_id покупки. Для inapp покупок — указанный при создании покупки в App Store или Google Play. Для Ecommerce — product_id товара.

{order_id} — идентификатор заказа.

Макросы только для inapp покупок

{inapp_transaction_id} — уникальный идентификатор покупки.

{inapp_validated} — провалидирована ли покупка в App Store или Google Play.

{inapp_receipt} — информация о покупке от App Store или Google Play.

Макросы только для Ecommerce покупок

{ecom_revenue} — полный доход от оформленной покупки.

{ecom_quantity} — количество единиц конкретного товара.

{ecom_product_name} — название товара.

{ecom_promocodes} — примененные промокоды.

{ecom_type} — тип ecommerce-события. Возможные значения:

  • 1 — показ экрана.
  • 2 — показ карточки товара в списке.
  • 3 — карточка товара.
  • 4 — добавление в корзину.
  • 5 — удаление из корзины.
  • 6 — начало оформления заказа.
  • 7 — покупка.

{ecom_category_path_1} — категория товара.

{ecom_category_path_2} — категория товара.

{ecom_category_path_3} — категория товара.

{ecom_category_path_4} — категория товара.

{ecom_category_path_5} — категория товара.

{ecom_category_path_6} — категория товара.

{ecom_category_path_7} — категория товара.

{ecom_category_path_8} — категория товара.

{ecom_category_path_9} — категория товара.

{ecom_category_path_10} — категория товара.

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

Написать в службу поддержки