Параметры 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} — категория товара.

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