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

Краткий обзор: Когда пользователи мобильных устройств выполняют установку приложений и какие-либо действия в приложениях, AppsFlyer отправляет постбэки в сети-источники рекламы и другие конечные точки, указанные в настройках. Эти постбэки могут содержать макросы.

AppsFlyer отправляет постбэки в рекламные сети, используя следующие источники данных:
  • Параметры ссылки атрибуции
    Параметры, предоставляемые партнером для URL-адресов нажатий или показов объявления, можно возвращать в составе URL-адресов для постбэков.
    Пример: параметр click ID в ссылке атрибуции — "&click_id=CLICK_ID"
  • Идентификаторы партнеров в AppsFlyer
    В постбэках можно возвращать уникальные идентификаторы, предоставляемые рекламодателю партнером.
    Примеры: идентификатор приложения, идентификатор аккаунта, идентификатор пользователя, идентификатор сети, ключ SDK и т. д.
  • Информация, полученная из SDK: Информация, полученная от устройства с помощью SDK AppsFlyer. Например: используя макрос «&IDFA=(idfa)» в постбэке, можно получить идентификаторы устройств iOS
  • Protect360 и правила проверки: информация об установках, которые признаны мошенническими, и об установках, нарушающих правила таргетинга кампании, а также связанные с ними события в приложении. 

Изменение настроек постбэков

  • Рекламные сети запрашивают изменение настроек макросов, обращаясь к своему менеджеру AppsFlyer по работе с партнерами.
  • Постбэки доступны для:
    • установок и внутренних событий
    • заблокированных установок и внутренних событий, заблокированных как мошеннические в Protect360 или из-за нарушения правил проверки таргетинга.

Макросы, поддерживаемые в постбэках

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

  • Источник: указывает, откуда получены данные (SDK или ссылка)
  • Отправить все: указывает, можете ли вы получать данные об установках и событиях, которые не атрибутируются вашей сети (в т.ч. органические данные)

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

Макрос Источник Описание Отправить все
(app-id) SDK Идентификатор приложения.  Y
(app-name) SDK Название приложения. Y
(app-version-name) SDK Версия приложения, заданная разработчиком в коде приложения. Y
(appName) SDK Название приложения (напр., com.appsflyer.adNetworkTest) Y
(appsflyer-device-id) SDK Уникальный идентификатор AppsFlyer, зафиксированный при конверсии. Y
(bundle-id) SDK Идентификатор приложения (напр., com.appsflyer.adNetworkTest) Y
(sdk-version) SDK Версия SDK AppsFlyer. Y
(campaign) Ссылка Название кампании, переданное в ссылке атрибуции AppsFlyer (c=). N
(click-ts) SDK Время нажатия или показа по ссылке атрибуции AppsFlyer. N
(unix-ts) SDK Метка времени в формате Unix-времени (напр., 1510000000) Y
(gp_referrer_click_ts) SDK Время входа в магазин Google Play. N
(gp_referrer_install_ts) SDK Время нажатия кнопки Install (Установить) в Google Play. N
(install-ts) SDK Метка времени установки Y
(install-unix-ts) SDK Метка времени установки (время первого открытия приложения) в формате UNIX. Y
(publisher_id) Ссылка Идентификатор сайта, переданный в ссылке атрибуции AppsFlyer (af_siteid=). Y
(match-type) SDK Тип соответствия атрибуции (напр., uid (id_matching), ref (gp_referrer) и fp (вероятностное моделирование)) N
(is_attributed) SDK Флаг для указания, что установка или событие атрибутируются данному медиа-источнику Y
(is-impression) SDK Флаг для указания, что атрибуция осуществлялась по просмотру (1 = показ, 0 = клик) N
(is-reattr-tf) SDK Флаг для указания, что это кампания реатрибуции (значения TRUE/FALSE) N
(is-reattr) SDK Флаг для указания, что это кампания реатрибуции (значения 1/0) N
(is-reengage-tf) SDK Флаг для указания, что это кампания повторного вовлечения (значения TRUE/FALSE) N
(is-reengage) SDK Флаг для указания, что это кампания повторного вовлечения (значения 0/1) N
(is-retarget-tf) SDK Флаг для указания, что это кампания ретаргетинга (значения TRUE/FALSE) N
(is-retarget) SDK Флаг для указания, что это кампания ретаргетинга (значения 1/0) N
(is-s2s-0or-1) SDK Источник установки или события — S2S / не S2S ( значения 1/0) Y
(is-s2s) SDK Источник установки или события — S2S / не S2S (значения TRUE/FALSE) Y
(is-tracking-disable-0-or-1) SDK Флаг для указания, что отслеживание рекламы отключено (значения 1/0) N
(is-tracking-disable) SDK Флаг для указания, что пользователь отключил функцию ограничения отслеживания рекламы (LAT). Значения TRUE или FALSE. N
(is-tracking-enable-0-or-1) SDK Флаг для указания, что пользователь включил функцию ограничения отслеживания рекламы (значения 1/0) Y
(is-tracking-enable) SDK Флаг для указания, что пользователь включил функцию ограничения отслеживания рекламы (значения TRUE/FALSE) Y
(android-id) SDK Уникальный идентификатор для устройств Android.
Другой вариант: (sha1-android-id)
Y
(idfa) SDK Уникальный идентификатор iOS.
Другой вариант: (sha1-idfa)
Y
(ip) SDK IP-адрес устройства пользователя, зафиксированный при конверсии. Y
(language) SDK Язык интерфейса устройства пользователя, зафиксированный при конверсии. Y
(operator) SDK Мобильный оператор пользователя (напр., airtel) Y
(os-version) SDK Версия операционной системы. Y
(platform) SDK Платформа устройства (IOS/Android) Y
(device-brand) SDK Марка устройства пользователя, зафиксированная при конверсии. Y
(device-model) SDK Модель устройства пользователя, зафиксированная при конверсии. Y
(device-type) SDK Тип устройства (напр., IPHONE, SAMSUNG) Y
(advertiserId) SDK Уникальный идентификатор GAID для устройств Android.
Другой вариант: (sha1-advertiserId)
Y
(user-agent) SDK Название пользовательского агента (например, "Mozilla/5.0 (iPad)". Y
(vendorId) SDK Идентификатор поставщика, например: IDFV для iOS. Y
(wifi) SDK Тип подключения для передачи данных, используемый пользователем при конверсии (значения TRUE/FALSE) Y
(carrier) SDK Оператор связи, к сети которого подключено устройство (например, «AT&T»). Y
(city) SDK Город, в котором находится устройство пользователя, зафиксированный при конверсии. Y
(region) SDK Регион IP-адреса пользователя Y
(state) SDK Страна IP-адреса пользователя  Есть 
(postal-code) SDK Почтовый индекс Y
(country-code) SDK Двузначный код страны, зафиксированный при конверсии. Y
(blocked-reason) Блокировка* Причина мошенничества (напр., devicerank, боты, кликфрод) N
(blocked-reason-value) Блокировка* Значение причины мошенничества (напр., ID рекламы, ID сайта) N
(transaction-id) SDK Уникальное значение, сгенерированное AppsFlyer (напр., DgC3kh7hWMMC-kPeFLSjNA) Y
(random-str) SDK Строка случайных символов, сгенерированная AppsFlyer. Y
(oaid) SDK Непостоянный идентификатор устройства Android Y
(blocked-sub-reason) Блокировка* Подпричина мошенничества (high_fraud_rate, new_devices) N
* Блокировка: Protect360 или правила проверки таргетинга, в зависимости от конкретного случая  

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

Макросы, описанные в этой таблице, можно использовать только в постбэках, которые отправляются партнерам после внутренних событий приложения (или S2S-событий).

Макрос Описание Отправить все 

(event-name)

Имя события, инициированного в приложении.

Y

(mapped-iae)

Имя/идентификатор соответствующего события на платформе партнера.

Y

(monetary)

Значение стоимости события в USD.

Y

(orig-monetary)

Значение стоимости события в исходной валюте, заданной в приложении

Y

(currency)

Код валюты события.

Y

(timestamp)

Время возникновения внутреннего события в приложении.

Y

(event-value)

Насыщенное внутреннее событие приложения с расширенными параметрами содержит атрибуты со значениями, которые можно целиком включать в постбэки в формате JSON и кодировать как URL-адрес, используя макрос (encode).

Y

(is-primary)

Флаг ретаргетинга, эквивалент столбцу "is-primary" в отчетах (значения TRUE/FALSE)

Y

 Пример

Шаблон постбэка события «&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?clickid=(clickid)&site_id=(publisher_id)
&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)
&install_time=(install-unix-ts)

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

Android iOS
http://YourCompanyDomain.com?clickid=(clickid)&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
Была ли эта статья полезной?