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

Краткий обзор: Как рекламная сеть при интеграции с 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). Поддерживаемые макросы перечислены в следующей таблице:

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

  • Источник: откуда пришли данные.
    • Link: Ссылки атрибуции:
    • SDK: SDK AppsFlyer, встроенный в приложение или межсерверный API.
    • AF: После обработки AppsFlyer.
  • Отправлять все: Если этот столбец содержит значение «Да», вы можете получать данные об установках и событиях, атрибутированных другим сетям или органических. (То есть атрибутированных не вам.)
  • [Основа] Макросы для всех постбэков: макросы, относящиеся к постбэкам об установках, внутренних событиях и отклоненных событиях.
  • [Дополнительно] для внутренних событий и отклоненных событий, как указано в столбце (отклонено, внутренние)

Макросы: установки, внутренние события приложения и отклоненные события

Макрос в постбэке (название) Источник Отправить все Описание [Основа] Макросы для всех постбэков [Дополнительно] Внутренние и отклоненные события
рекламный_идентификатор SDK Да Сбрасываемый пользователем идентификатор устройства, также известный как GAID. Другой вариант: (sha1-advertiserId) Да  
af_ad Ссылка Нет Название рекламы (см. подробнее), предоставленное рекламодателем/издателем Да Да
af_ad_id Ссылка Нет Предоставлено рекламодателем/издателем Да Да
af_ad_type Ссылка Нет Используйте следующее соглашение об именовании:
  • текст: рекламный блок, содержащий только текст, например результат поиска
  • баннер: базовый формат, который отображается в верхней или нижней части экрана устройства
  • межстраничное объявление: полностраничное объявление, которое появляется во время перерывов в текущем опыте
  • видео: стандартное видео, без вознаграждения
  • rewarded_video: рекламный блок, предлагающий награды в приложении в обмен на просмотр видео
  • playable: рекламный блок, содержащий интерактивный предварительный просмотр приложения
  • sponsored_content: ссылка, включенная в фрагмент заказного контента, например, в рекламную статью
  • аудио: аудиореклама
Да Да
af_adset Ссылка Нет
  • Предоставляется рекламодателем/издателем.
  • Адсет — это промежуточный уровень в иерархии между кампанией и рекламным объявлением. Подробнее
Да Да
af_adset_id Ссылка Нет Предоставлено рекламодателем/издателем Да Да
af_c_id Ссылка Нет Предоставлено рекламодателем/издателем Да Да
af_siteid Ссылка Нет
  • Уникальный идентификатор, определяющий издателя, показывающего рекламу. Узнать больше
Да Да
af_subsite_id Ссылка Нет
  • ID подсети/издателя.
  • Если в дополнение к основному издателю (ID сайта) существует субиздатель, или вы хотите включить дополнительную информацию, такую как тип/размещение рекламы в приложении, например баннер, межстраничная реклама, видео и т.д., используйте af_sub_siteid. Например: af_sub_siteid =ABCD_4567
Да Да
af_validated AF Да Показывает, прошла ли покупка успешную валидацию. Возможные значения: true или false. Да  
af_validation_type AF Да Указывает тип проведённой валидации. Возможные значения: roi360_purchase, roi360_subscription, Basic. Да  
app_id SDK Да Идентификатор приложения, сообщенный приложением  Да  
имя_приложения SDK Да Имя приложения, заданное рекламодателем Да  
версия_приложения SDK Да Имя версии приложения, заданное разработчиком в коде приложения. Да  
appsflyer_id SDK Да Уникальный идентификатор AppsFlyer, зафиксированный при конверсии. Да  
att-0-1 SDK Да Возможные значения:
  • 1: Статус ATT authorized или af_authorized.
  • 0: Любой другой статус ATT. 
Да  
att-status SDK Да

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

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

Да  
attributed_touch_type (атрибутированный тип взаимодействия) SDK Нет Возможные значения: click, impression, TV, pre-install (клик, показ, ТВ, предустановка) Да  
заблокированная_причина AF Нет Причина блокировки: мошенничество / нарушение правил проверки Нет Отклонено
заблокированное_значение_причины AF Нет Значение причины блокировки из-за мошенничества / нарушения правил проверки Нет Отклонено
заблокированная_подпричина AF Нет Частная причина блокировки из-за мошенничества / нарушения правил проверки Нет Отклонено
bundle_id SDK Да iOS: Идентификация для сопоставления одного Приложения или группы Приложений в iOS (см. идентификатор пакета разработчика Apple) Android: Название приложения Да  
c Ссылка Нет Предоставляется рекламодателем/издателем. Имя кампании, превышающее 100 символов, отображается на панели управления как "c_name_exceeded_max_length". Да Да
country_code AF Да Код страны согласно ISO 3166 (alpha-2) Пример: США, Китай. Да  
event_name (название события) SDK Да Имя, присвоенное событию Нет В приложении
event_revenue SDK Да Значение события, определенное SDK с помощью event_revenue_currency или выбранной вами валюты. Нет В приложении
event_revenue
_валюта
SDK Да Код валюты дохода от события, переданный для события, или выбранной вами валюты. Нет В приложении
event_revenue_USD AF Да Значение стоимости события в USD. Нет В приложении
время_события SDK Да Время события Нет В приложении
event_value SDK Да Внутреннее событие приложения содержит атрибуты со значениями, которые можно целиком включать в постбэки в формате JSON и кодировать как URL-адрес, используя макрос (encode). Нет В приложении
idfa SDK Да Идентификатор рекламного объявления, который может быть сброшен пользователем, на устройствах iOS. Также доступен как (sha1-idfa) Да  
idfv SDK Да Уникальный идентификатор для каждого пользователя и поставщика на устройствах iOS Да  
imei SDK Да Уникальный номер, используемый для идентификации мобильных телефонов Да  
время_установки SDK Да Метка времени установки Да  
install_unix_ts SDK Да Метка времени установки в формате unix Да  
is_attributed AF Да Флаг для указания, что установка или событие атрибутируются данному медиа-источнику Да  
is_contrib AF Да Показывает, была ли рекламная сеть среди трёх основных сетей, поспособствовавших установке.
  • Если рекламная сеть не получила атрибуцию, но находится в тройке лучших, is_contrib=1.
  • Если рекламная сеть получила атрибуцию, is_contrib=0.
  • Если рекламная сеть не входит в тройку лучших, is_contrib=0.
Да  
is_lat SDK Да Ограничение отслеживания рекламы (LAT): iOS: Начиная с iOS 14 LAT устарело в Apple. Определите статус конфиденциальности пользователя с помощью ATT. В этом случае игнорируйте is_lat. До iOS 14, если true, IDFA недоступен и установлен в 0. Android: Если true, пользователь отказался от рекламы на основе интересов. Это не мешает сбору GAID. Да  
is_organic AF Да

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

 

Только установки  
is_primary_attribution AF Да Если установлено значение false, см. is_retargeting. Нет В приложении
is_retargeting Ссылка Нет

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

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

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

 

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

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

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

Пример

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