How can we help?

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

  • Обновлено

Краткий обзор: Как рекламная сеть при интеграции с 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 Нет Частная причина блокировки из-за мошенничества / нарушения правил проверки Нет Отклонено
Авторизовано SDK (пакет средств разработки ПО) Да iOS: Идентификация для сопоставления одного Приложения или группы Приложений в iOS (см. идентификатор пакета разработчика Apple) Android: Название приложения Да  
c Ссылка Нет Предоставляется рекламодателем/издателем. Имя кампании, превышающее 100 символов, отображается на панели управления как "c_name_exceeded_max_length". Да Да
код_страны 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). и кодировать как 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_reinstall AF Нет Если установлено значение true, событие указывается в отчетности как переустановка.    
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

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: