Краткий обзор. Как рекламная сеть при интеграции с 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 | Да |
Возможные значения:
|
Да | |
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_ad_type | Ссылка | Нет |
Используйте следующие принятые наименования:
|
Да | Да |
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-кодирование.
Чтобы декодировать и закодировать постбэк, используйте веб-службу.
Примеры постбэков
Типовые примеры постбэков для установок
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)
http://YourCompanyDomain.com?&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install_unix_ts)
Типовые примеры постбэков для внутренних событий приложения
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)¤cy=(currency)&
json=(event_value)
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&idfa=(idfa)&install_time=(install_unix_ts)
&event_name=(event_name)¤cy=(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