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

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

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

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

  • Настройка постбэков: чтобы запросить изменения в настройках постбэков, используйте виджет помощи партнерам или обратитесь к менеджеру 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 Да Метка времени установки Да  
install_unix_ts SDK Да Метка времени установки в формате unix Да  
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.

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

Да  
af_ad Ссылка Нет

Название рекламного объявления (подробнее) — предоставляется рекламодателем или издателем.

Да Да
af_ad_id Ссылка Нет

Предоставляется рекламодателем или издателем

Да Да
af_adset Ссылка Нет
  • Предоставляется рекламодателем или издателем.
  • Группа объявлений — это промежуточный уровень в иерархии между кампанией и рекламным объявлением. Подробнее
Да Да
af_adset_id Ссылка Нет Предоставляется рекламодателем или издателем Да Да
c Ссылка Нет Предоставляется рекламодателем или издателем. Названия кампаний, превышающие 100 символов, отображаются на дэшборде как «c_name_exceeded_max_length» Да Да
af_c_id Ссылка Нет Предоставляется рекламодателем или издателем Да Да
af_siteid Ссылка Нет
  • Уникальный идентификатор, определяющий издателя, показывающего рекламу. Узнать больше
Да Да
af_subsite_id Ссылка Нет
  • Идентификатор рекламной субсети или издателя. 
  • Если помимо основного издателя (идентификатор сайта), есть еще субиздатель, или вы хотите включить дополнительную информацию, например, тип/размещение рекламы в приложении (баннер, рекламная вставка, видео и т. п.), используйте параметр af_sub_siteid. Например: af_sub_siteid =ABCD_4567
Да Да
af_ad_type Ссылка Нет

Используйте следующие принятые наименования:

  • text: элемент рекламы, содержащий только текст, например, результат поиска
  • banner: базовый формат, который демонстрируется вверху или внизу экрана устройства
  • interstitial: реклама  на всю страницу, которая демонстрируется в промежутках между текущим интерфейсом
  • video:  стандартное видео, бонусы не предоставляются
  • rewarded_video: рекламный блок, за просмотр которого приложение предоставляет бонусы
  • playable: интерактивный рекламный блок для предварительного ознакомления с приложением
  • sponsored_content:  ссылка, включенная в фрагмент заказного контента, например, в рекламную статью
  • audio: звуковое объявление
Да Да
imei SDK Да

Уникальный номер, используемый для идентификации мобильных телефонов

Да  

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

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

Пример

Шаблон постбэка события «&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