Макросы, используемые в AppsFlyer для постбэков

  • Рекламодатели
  • Рекламные сети

Введение

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

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

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

    integration_key.png

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

 Важно!

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

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

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

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

Макрос Источник Описание

(idfa)

SDK

Уникальный идентификатор iOS.
Другой вариант: (sha1-idfa)

(advertiserId)

SDK

Уникальный идентификатор GAID для устройств Android.
Другой вариант: (sha1-advertiserId)

(android-id)

SDK

Уникальный идентификатор для устройств Android.
Другой вариант: (sha1-android-id)

(app-id)

SDK

Идентификатор приложения. 

(wifi)

SDK

Тип подключения для передачи данных, используемый пользователем при конверсии ("TRUE" или "FALSE").

(install-unix-ts)

SDK

Метка времени установки (время первого открытия приложения) в формате UNIX.

(click-ts)

SDK

Время клика или просмотра по ссылке отслеживания AppsFlyer.

(campaign)

Ссылка

Название кампании, переданное в ссылке отслеживания AppsFlyer (c=).

(publisher_id)

Ссылка

Идентификатор сайта, переданный в ссылке отслеживания AppsFlyer (af_siteid=).

(country-code)

SDK

Двузначный код страны, зафиксированный при конверсии.

(city)

SDK

Город, в котором находится устройство пользователя, зафиксированный при конверсии.

(device-brand)

SDK

Марка устройства пользователя, зафиксированная при конверсии.

(carrier)

SDK

Оператор связи, к сети которого подключено устройство (например, «AT&T»).

(ip)

SDK

IP-адрес устройства пользователя, зафиксированный при конверсии.

(device-model)

SDK

Модель устройства пользователя, зафиксированная при конверсии.

(language)

SDK

Язык интерфейса устройства пользователя, зафиксированный при конверсии.

(appsflyer-device-id)

SDK

Уникальный идентификатор AppsFlyer, зафиксированный при конверсии.

(sdk-version)

SDK

Версия SDK AppsFlyer.

(app-version-name)

SDK

Версия приложения, заданная разработчиком в коде приложения.

(user-agent)

SDK

Название пользовательского агента (например, "Mozilla/5.0 (iPad)".

(vendorId)

SDK

Идентификатор поставщика, например: IDFV для iOS.

(os-version)

SDK

Версия операционной системы.

(app-name)

SDK

Название приложения.

(match-type)

SDK

Метод атрибуции (например, uid (id_matching), ref (gp_referrer) или fp (fingerprint)).

(gp_referrer_click_ts)

SDK

Время входа в магазин Google Play.

(gp_referrer_install_ts)

SDK

Время нажатия кнопки Install (Установить) в Google Play.


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

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

Макрос Описание

(event-name)

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

(mapped-iae)

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

(monetary)

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

(orig-monetary)

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

(currency)

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

(timestamp)

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

(event-value)

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

 Пример

Шаблон постбэка события «&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
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 3 из 3