Использование макросов в постбэках для рекламных сетей

Краткий обзор. Как рекламная сеть при интеграции с AppsFlyer вы можете определять контент постбэков и конечные точки, на которые AppsFlyer отправляет эти постбэки. В постбэках содержится информация об интеракциях пользователей приложения, например, об установках, событиях в приложении, повторных вовлечениях и т. п.

Руководства по постбэкам для интегрированных партнеров:

Постбэки для рекламных сетей

  • Настройка постбэков. Чтобы запросить изменение настроек ваших постбэков, обратитесь к нам по адресу integrations@appsflyer.com или через своего менеджера AppsFlyer по работе с партнерами. 
  • Типы постбэков: доступны постбэки по установкам и внутренним событиям, а также по установкам и внутренним событиям, заблокированным как мошеннические в Protect360 или из-за нарушения правил проверки таргетинга.
Источники данных постбэков
Источник Описание
Параметры ссылки атрибуции

Параметры, предоставляемые партнером вместе с URL-адресами для учета кликов и показов объявления

Пример: параметр click ID в ссылке атрибуции — "&click_id=CLICK_ID"

Идентификаторы партнеров в AppsFlyer

Уникальные идентификаторы, предоставляемые рекламодателю партнером

Например, ID приложения, ID аккаунта, ID пользователя, ID сети.

Информация, полученная из SDK

Информация, полученная от устройства с помощью SDK AppsFlyer.

Например: используя макрос «&IDFA=(idfa)» в постбэке, можно получить идентификаторы устройств iOS

Получено платформой AppsFlyer

Информация, полученная платформой AppsFlyer. 

Protect360 и правила проверки Информация об установках, которые признаны мошенническими, и об установках, нарушающих правила таргетинга кампании, а также связанные с ними события в приложении.

Макросы в постбэках

При включении в постбэк макросы заменяются соответствующими пользовательскими данными. Например, для получения IP-адресов пользователей, устанавливающих приложение, нужно добавить в структуру постбэка макрос country_code=(ip).  Поддерживаемые макросы перечислены в следующей таблице:

Столбцы в таблице ниже имеют следующее значение:

  • Источник: откуда пришли данные.
    • Ссылка: ссылки атрибуции
    • SDK: AppsFlyer SDK, встроенный в приложение или межсерверный API
    • AF: после обработки AppsFlyer
  • Отправлять все. Если этот столбец содержит значение «Да», вы можете получать данные об установках и событиях, атрибутированных другим сетям или органических  (то есть атрибутированных не вам). 
  • [Основа] Макросы для всех постбэков: макросы, относящиеся к постбэкам об установках, внутренних событиях и отклоненных событиях.
  • [Дополнительно] для внутренних событий и отклоненных событий, как указано в столбце (отклонено, внутренние)
Макросы: установки, внутренние события приложения и отклоненные события
Макрос в постбэке (название) Источник Отправить все Описание [Основа] Макросы для всех постбэков [Дополнительно] Внутренние и отклоненные события
advertising_id SDK Да Идентификатор устройства, который пользователь может сбросить, он же GAID. Другой вариант: (sha1-advertiserId) Да  
app_name SDK Да Имя приложения, заданное рекламодателем Да  
appsflyer_id SDK Да Уникальный идентификатор AppsFlyer, зафиксированный при конверсии. Да  
attributed_touch_type SDK Нет Возможные значения: click, impression, TV, pre-install (клик, показ, ТВ, предустановка) Да  
blocked_reason AF Нет Причина блокировки: мошенничество / нарушение правил проверки Нет Отклонено
blocked_reason_value AF Нет Значение причины блокировки из-за мошенничества / нарушения правил проверки Нет Отклонено
blocked_sub_reason AF Нет Частная причина блокировки из-за мошенничества / нарушения правил проверки Нет Отклонено
bundle_id SDK Да iOS: идентификатор одного приложения или группы приложений в iOS (см. идентификатор группы разработчика Apple) Android: имя приложения Да  
country_code AF Да Код страны в соответствии с ISO 3166 (alpha-2) Пример: US, CN. Да  
event_name SDK Да Имя, присвоенное событию Нет Покупки в
event_revenue_USD AF Да Значение стоимости события в USD. Нет Покупки в
event_revenue SDK Да Значение события, определенное SDK с помощью event_revenue_currency или выбранной вами валюты. Нет Покупки в
event_revenue
_currency
SDK Да Код валюты дохода от события, переданный для события, или выбранной вами валюты. Нет Покупки в
event_time SDK Да Event Time (Время события) Нет Покупки в
event_value SDK Да Внутреннее событие приложения содержит атрибуты со значениями, которые можно целиком включать в постбэки в формате JSON и кодировать как URL-адрес, используя макрос (encode). Нет Покупки в
idfa SDK Да Идентификатор рекламного объявления, который может быть сброшен пользователем, на устройствах iOS. Также доступен как (sha1-idfa) Да  
idfv SDK Да Уникальный идентификатор для каждого пользователя и поставщика на устройствах iOS Да  
install_time SDK Да Метка времени установки Да  
is_attributed AF Да Флаг для указания, что установка или событие атрибутируются данному медиа-источнику Да  
is_lat SDK Да Ограничение отслеживания рекламы (LAT): iOS. Начиная с iOS 14, Apple устраняет LAT. Определяйте статус конфиденциальности пользователя помощью ATT. В этом случае проигнорируйте is_lat. До iOS 14: если установлено значение true, IDFA не доступен и задано значение 0. Android: если установлено значение true, пользователь отказался от рекламы по интересам. Это не мешает сбору GAID. Да  
is_primary_attribution AF Да

Если установлено значение false, см. is_retargeting.

Нет Покупки в
is_retargeting Ссылка Нет

Используйте вместе с is_primary_attribution. Подробнее о двойной атрибуции событий ретаргетинга.

Если установлено значение true (1), событие регистрируется как часть кампании ретаргетинга, а медиа-источник является медиа-источником ретаргетинга.

Если установлено значение false (0) и для is_primary_attribution тоже значение false, то событие является частью кампании ретаргетинга, но медиа-источник будет медиа-источником атрибуции пользователя.

 

Нет  
language SDK Да Язык (местный), сообщается устройством, устанавливается ОС устройства. Да  
oaid SDK Да Идентификатор, который может быть сброшен пользователем, на некоторых устройствах Android, обычно альтернатива GAID Да  
partner_event_id AF Да Имя/идентификатор соответствующего события на платформе партнера. Нет Покупки в
platform SDK Да Платформа устройства: iOS, Android или Windows Mobile Да  
retargeting_
conversion_type
AF Нет Флаг для указания, является ли событие реатрибуцией или повторным вовлечением Только для ретаргетинга  
app_version SDK Да Имя версии приложения, заданное разработчиком в коде приложения. Да  
app_id SDK Да Идентификатор приложения, сообщенный приложением Да  
att-0-1 SDK Да

Возможные значения:

  • 1: Статус ATT authorized или af_authorized.
  • 0: Любой другой статус ATT. 
Да  
att-status SDK Да

Статус ATT от iOS. Напр., authorized, not_determined.

В некоторых случаях значение отсутствует и возвращается "".

Да  

Макросы, применимые только для внутренних событий приложения

Приведенные ниже примеры относятся к постбэкам по внутренним событиям, доступным партнерам.

Пример

Шаблон постбэка события «&event=(event)&json=(encode)» был преобразован в следующий постбэк для конкретного события af_purchase:

&event=af_purchase&json=%7B%22af_quantity%22%3A1%2C%22
af_revenue%22%3A%2212000%22%2C%22af_currency%22%3A%
22USD%22%2C%22af_content_id%22%3A%221107%22%2C%22
af_content_type%22%3A%22default_type%22%7D%0A


После преобразования этот постбэк в формате JSON будет содержать следующие параметры:

{"af_quantity":1,"af_revenue":"12000","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}


Кодирование значений

В некоторых случаях в постбэки, кроме букв и цифр, могут включаться нестандартные символы. Чтобы правильно передать такие значения через постбэки, AppsFlyer использует для нестандартных символов URL-кодирование.

Чтобы декодировать и закодировать постбэк, используйте веб-службу.

Примеры постбэков

Типовые примеры постбэков для установок

Android iOS
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)

Типовые примеры постбэков для внутренних событий приложения

Android iOS
http://YourCompanyDomain.com?site_id=(publisher_id)&
device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android_id)&
install_time=(install_unix_ts)&event_name=(event_name)&currency=(currency)&
json=(event_value)

 Пример постбэка по внутреннему событию

Параметры события:

  • Имя события: af_revenue
  • Доход от события: 120.00
  • Валюта события: USD
  • Значение события: {"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Постбэк:

http://YourCompanyDomain.com?clickid=8594845&site_id=click123&device_ip=
38.166.144.142&advertising_id=121sxxxx-xxxx-xxxx-xxxx-52454bd7500b&
android_id=9aaeecc4455xxxxx&;install_time=1451923560&event_name=af_purchase&
currency=USD&revenue=120.00&json=%7B%22af_quantity%22%3A1%2C%22 />af_revenue
%22%3A%22120.10%22%2C%22af_currency%22%3A%22USD%22%2C%22af_content_id
%22%3A%221107%22%2C%22af_content_type%22%3A%22default_type%22%7D%0A
Была ли эта статья полезной?