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

Введение

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

Есть 3 различных источника данных для постбэков, которые AppsFlyer может отправлять рекламным сетям.

  1. Параметры ссылки атрибуции
    Параметры, предоставляемые партнером для URL-адресов нажатий или показов объявления, можно возвращать в составе URL-адресов для постбэков.
    Пример: параметр click ID в ссылке атрибуции — "&click_id=CLICK_ID"
  2. Идентификаторы партнеров в AppsFlyer
    В постбэках можно возвращать уникальные идентификаторы, предоставляемые рекламодателю партнером.
    Примеры: идентификатор приложения, идентификатор аккаунта, идентификатор пользователя, идентификатор сети, ключ SDK и т. д.

    ad_network_key.png

  3. Информация, полученная из SDK
    Информация, полученная от устройства с помощью SDK AppsFlyer. 
    Пример: используя макрос «&IDFA=(idfa)», в постбэк можно включить идентификаторы устройств iOS. 

 Важно!

Если рекламной сети необходимо обновить структуру постбэков и набор возвращаемых данных, ей следует обратиться к представителю AppsFlyer по работе с партнерами.

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

Ниже приведен полный перечень макросов, которые можно использовать в 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 (fingerprint)). 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
(af_lat) SDK LATITUDE Y
(af_long) SDK LONGITUDE Y
(blocked-reason) SDK Причина мошенничества (напр., devicerank, боты, кликфрод) N
(blocked-reason-value) SDK Значение причины мошенничества (напр., ID рекламы, ID сайта) N
(transaction-id) SDK Уникальное значение, сгенерированное AppsFlyer (напр., DgC3kh7hWMMC-kPeFLSjNA) Y
(random-str) SDK Строка случайных символов, сгенерированная AppsFlyer. Y

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

Макросы, описанные в этой таблице, можно использовать только в постбэках, которые отправляются партнерам после внутренних событий приложения (или 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
Была ли эта статья полезной?