Чем мы можем помочь?

Поиск

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

  • Обновлено

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

Постбэки для партнеров по аналитике

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

  • Настройка постбэков: Чтобы запросить изменения в настройках постбэков, используйте виджет помощника партнера, чтобы открыть тикет, или обратитесь к менеджеру AppsFlyer по развитию партнеров.
  • Типы постбэков: постбэки доступны для установок и событий в приложении.

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

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

  • Источник: откуда пришли данные:
    • SDK: SDK AppsFlyer, встроенный в приложение или межсерверный API.
    • AF: После обработки AppsFlyer.
  • [Base] Макросы для всех постбэков: макросы, относящиеся к установкам и событиям в приложении.
  • [Необязательно] для событий в приложении, как указано в столбце.

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

Макрос в постбэке (название) Информация на дэшборде Description(Описание) [Основа] Макросы для всех постбэков [Необязательно] События в приложении
рекламный_идентификатор SDK (пакет средств разработки ПО) Идентификатор устройства, который пользователь может сбросить, он же GAID. Другой вариант: (sha1-advertiserId) Да
имя_события SDK (пакет средств разработки ПО) Имя, присвоенное событию Да
event_revenue_USD AF Значение стоимости события в USD. Да
event_revenue SDK (пакет средств разработки ПО) Значение события, определенное SDK с помощью event_revenue_currency или выбранной вами валюты. Да
event_currency SDK (пакет средств разработки ПО) Код валюты дохода от события, переданный в событии, или код выбранной вами валюты. Да
время_события SDK (пакет средств разработки ПО) Event Time (Время события) Да
event_value SDK (пакет средств разработки ПО) Внутреннее событие приложения содержит атрибуты со значениями, которые можно целиком включать в постбэки в формате JSON и кодировать как URL-адрес, используя макрос (encode). и кодировать как URL-адрес, используя макрос (encode). Да
partner_event_id AF Имя/идентификатор соответствующего события на платформе партнера. Да
имя_приложения SDK (пакет средств разработки ПО) Имя приложения, заданное рекламодателем Да
appsflyer_id SDK (пакет средств разработки ПО) Уникальный идентификатор AppsFlyer, зафиксированный при конверсии. Да
attributed_touch_type (атрибутированный тип взаимодействия) AF Флаг для указания, что атрибуция осуществлялась по просмотру (1 = показ, 0 = клик) Да
код_страны AF Код страны согласно ISO 3166 (alpha-2) Пример: США, Китай. Да
IDFA SDK (пакет средств разработки ПО) Идентификатор рекламного объявления, который может быть сброшен пользователем, на устройствах iOS. Также доступен как (sha1-idfa) Да
IDFV SDK (пакет средств разработки ПО) Уникальный идентификатор для каждого пользователя и поставщика на устройствах iOS Да
время_установки SDK (пакет средств разработки ПО) Метка времени установки Да
install_unix_ts SDK (пакет средств разработки ПО) Метка времени установки в формате unix Да
is_lat SDK (пакет средств разработки ПО) Ограничение отслеживания рекламы (LAT): iOS: Начиная с iOS 14 LAT устарело в Apple. Определите статус конфиденциальности пользователя с помощью ATT. В этом случае игнорируйте is_lat. До версии iOS 14, если установлено значение true, то IDFA не доступен и отображается 0. Android: Если true, пользователь отказался от рекламы на основе интересов. Это не мешает сбору GAID. Да
язык SDK (пакет средств разработки ПО) Язык (местный), сообщается устройством, устанавливается ОС устройства. Да
app_id (идентификатор приложения) SDK (пакет средств разработки ПО) Уникальный идентификатор приложения в AppsFlyer Да
app-version-name SDK (пакет средств разработки ПО) Версия приложения, установленная разработчиком приложения в коде приложения Да
attributed_touch time AF Время взаимодействия, которому AppsFlyer присвоил атрибуцию. Да
тип_устройства SDK (пакет средств разработки ПО) Доступно только в расширенных отчётах. Пример: SM-GM284 или iPhone7 Да
ip AF IP-адрес устройства пользователя, сообщающего о событии Да
Местоположение устройства AF Тип метода атрибуции. Например, srn, id_matching, probabilistic Да
os_version SDK (пакет средств разработки ПО) Версия операционной системы устройства Да
user_agent SDK (пакет средств разработки ПО) Агент пользователя URL-адреса Да
Информация об устройстве SDK (пакет средств разработки ПО) Если true, подключение было по Wi-Fi в момент конверсии Да
oaid SDK (пакет средств разработки ПО) Сбросный идентификатор на некоторых устройствах Android, обычно альтернатива GAID Да
platform SDK (пакет средств разработки ПО) Платформа устройства: iOS, Android или Windows Mobile Да
тип_конверсии_ретаргетинга SDK (пакет средств разработки ПО) Флаг для указания, является ли событие реатрибуцией или повторным вовлечением Да
pid AF Рекламная сеть, которой атрибутируется установка или событие в приложении Да
af_ad Атрибуция PBA Название рекламы (см. подробнее), предоставленное рекламодателем/издателем Да Да
af_ad_id Атрибуция PBA Предоставляется рекламодателем или издателем Да Да
af_adset Атрибуция PBA
  • Предоставляется рекламодателем/издателем.
  • Адсет — это промежуточный уровень в иерархии между кампанией и рекламным объявлением. Подробнее
Да Да
af_adset_id Атрибуция PBA Предоставляется рекламодателем или издателем Да Да
c Атрибуция PBA Предоставляется рекламодателем/издателем. Имя кампании, превышающее 100 символов, отображается на панели управления как "c_name_exceeded_max_length". Да Да
af_c_id Атрибуция PBA Предоставляется рекламодателем или издателем Да Да
af_siteid Атрибуция PBA
  • Уникальный идентификатор, определяющий издателя, показывающего рекламу. Узнать больше
Да Да
af_subsite_id Атрибуция PBA
  • ID подсети/издателя.
  • Если в дополнение к основному издателю (ID сайта) существует субиздатель, или вы хотите включить дополнительную информацию, такую как тип/размещение рекламы в приложении, например баннер, межстраничная реклама, видео и т.д., используйте af_sub_siteid. Например: af_sub_siteid =ABCD_4567
 Да Да
af_ad_type Атрибуция PBA Используйте следующее соглашение об именовании:
  • text: рекламный блок, содержащий только текст, например результат поиска
  • banner: базовый формат, который отображается в верхней или нижней части экрана устройства
  • interstitial: полностраничное объявление, которое появляется во время перерывов в текущем опыте
  • video: стандартное видео без вознаграждения
  • rewarded_video: рекламный блок, предлагающий награды в приложении в обмен на просмотр видео
  • playable: рекламный блок, содержащий интерактивный предварительный просмотр работы приложения
  • sponsored_content: ссылка, включенная в спонсируемый контент, например в рекламную статью
  • аудио: аудиореклама
 Да Да

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

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

Например

Шаблон постбэка события &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%22af_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?pid=(media_source)&advertising_id=(advertiserId)&android_id=(android-id)&install_time=(install-unix-ts)
adjusted.png 
http://YourCompanyDomain.com?pid=(media source)&device_ip=(ip)&idfa=(idfa)&install_time=(install-unix-ts)

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

AndroidiOS 
http://YourCompanyDomain.com?pid=(media_source)&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)&install_time=(install-unix-ts)&event_name=(event-name)&currency=(currency)&json=(event-value)
https://support.appsflyer.com/hc/en-us/articles/207447023 
http://YourCompanyDomain.com?pid=(media_source)&device_ip=(ip)&idfa=(idfa)&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?pid=(media_source)&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

Tags