Введение
Когда пользователи мобильных устройств выполняют установку приложений или какие-либо другие действия в приложениях, AppsFlyer отправляет постбэки в сети-источники рекламы или другие конечные точки. Эти постбэки могут содержать макросы.
-
Параметры ссылки атрибуции
Параметры, предоставляемые партнером для URL-адресов нажатий или показов объявления, можно возвращать в составе URL-адресов для постбэков.
Пример: параметр click ID в ссылке атрибуции — "&click_id=CLICK_ID" -
Идентификаторы партнеров в AppsFlyer
В постбэках можно возвращать уникальные идентификаторы, предоставляемые рекламодателю партнером.
Примеры: идентификатор приложения, идентификатор аккаунта, идентификатор пользователя, идентификатор сети, ключ SDK и т. д.
-
Информация, полученная из SDK
Информация, полученная от устройства с помощью SDK AppsFlyer.
Пример: используя макрос «&IDFA=(idfa)», в постбэк можно включить идентификаторы устройств iOS.
Важно!
Если рекламной сети необходимо обновить структуру постбэков и набор возвращаемых данных, ей следует обратиться к представителю AppsFlyer по работе с партнерами.
Макросы, поддерживаемые в постбэках
Ниже приведен полный перечень макросов, которые можно использовать в AppsFlyer. При включении в постбэк эти макросы автоматически заменяются соответствующими пользовательскими данными. Например, для получения IP-адресов пользователей, устанавливающих приложение, нужно добавить в структуру постбэка макрос «&ip_address=(ip)».
Макросы для получения данных об установках и внутренних событиях приложения
Макрос | Источник | Описание |
---|---|---|
|
SDK |
Уникальный идентификатор iOS. |
|
SDK |
Уникальный идентификатор GAID для устройств Android. |
|
SDK |
Уникальный идентификатор для устройств Android. |
|
SDK |
Идентификатор приложения. |
|
SDK |
Тип подключения для передачи данных, используемый пользователем при конверсии ("TRUE" или "FALSE"). |
|
SDK |
Метка времени установки (время первого открытия приложения) в формате UNIX. |
|
SDK |
Время нажатия или показа по ссылке атрибуции AppsFlyer. |
|
Ссылка |
Название кампании, переданное в ссылке атрибуции AppsFlyer (c=). |
|
Ссылка |
Идентификатор сайта, переданный в ссылке атрибуции AppsFlyer (af_siteid=). |
|
SDK |
Двузначный код страны, зафиксированный при конверсии. |
|
SDK |
Город, в котором находится устройство пользователя, зафиксированный при конверсии. |
|
SDK |
Марка устройства пользователя, зафиксированная при конверсии. |
|
SDK |
Оператор связи, к сети которого подключено устройство (например, «AT&T»). |
|
SDK |
IP-адрес устройства пользователя, зафиксированный при конверсии. |
|
SDK |
Модель устройства пользователя, зафиксированная при конверсии. |
|
SDK |
Язык интерфейса устройства пользователя, зафиксированный при конверсии. |
|
SDK |
Уникальный идентификатор AppsFlyer, зафиксированный при конверсии. |
|
SDK |
Версия SDK AppsFlyer. |
|
SDK |
Версия приложения, заданная разработчиком в коде приложения. |
|
SDK |
Название пользовательского агента (например, "Mozilla/5.0 (iPad)". |
|
SDK |
Идентификатор поставщика, например: IDFV для iOS. |
|
SDK |
Версия операционной системы. |
|
SDK |
Название приложения. |
|
SDK |
Метод атрибуции (например, uid (id_matching), ref (gp_referrer) или fp (fingerprint)). |
|
SDK |
Время входа в магазин Google Play. |
|
SDK |
Время нажатия кнопки Install (Установить) в Google Play. |
|
SDK |
Флажок включения пользователем функции ограничения отслеживания рекламы (LAT). Может принимать значение "TRUE" или "FALSE". |
Макросы, применимые только для внутренних событий приложения
Макросы, описанные в этой таблице, можно использовать только в постбэках, которые отправляются партнерам после внутренних событий приложения (или S2S-событий).
Макрос | Описание |
---|---|
|
Имя события, инициированного в приложении. |
|
Имя/идентификатор соответствующего события на платформе партнера. |
|
Значение стоимости события в USD. |
|
Значение стоимости события в исходной валюте, заданной в приложении |
|
Код валюты события. |
|
Время возникновения внутреннего события в приложении. |
|
Насыщенное внутреннее событие приложения с расширенными параметрами содержит атрибуты со значениями, которые можно целиком включать в постбэки в формате 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-кодирование.
Для декодирования и кодирования постбэков можно использовать бесплатные веб-службы, например эту.
Примеры постбэков
Типовые примеры постбэков для установок
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)
&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)
&install_time=(install-unix-ts)
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install-unix-ts)
Типовые примеры постбэков для внутренних событий приложения
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)¤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