Краткий обзор: Как рекламная сеть при интеграции с 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 | Ссылка | Нет | Используйте следующее соглашение об именовании:
|
Да | Да |
| af_adset | Ссылка | Нет |
|
Да | Да |
| af_adset_id | Ссылка | Нет | Предоставлено рекламодателем/издателем | Да | Да |
| af_c_id | Ссылка | Нет | Предоставлено рекламодателем/издателем | Да | Да |
| af_siteid | Ссылка | Нет |
|
Да | Да |
| af_subsite_id | Ссылка | Нет |
|
Да | Да |
| 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 | Да | Возможные значения:
|
Да | |
| 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_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-кодирование.
Чтобы декодировать и закодировать постбэк, используйте веб-службу.
Примеры постбэков
Типовые примеры постбэков для установок
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