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

Краткий обзор: Когда пользователи мобильных устройств выполняют установку приложений и какие-либо действия в приложениях, 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 или ссылка)
• Отправить все: указывает, можете ли вы получать данные об установках и событиях, которые не атрибутируются вашей сети (в т.ч. органические данные)

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

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

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

&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

{"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)&currency=(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)&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