Руководство по режиму расширенной конфиденциальности и макросы в постбэках для рекламных сетей

Во многих случаях, в зависимости от наличия согласия пользователя на ATT, идентификатор IDFA будет недоступен в приложении издателя, приложении рекламодателя или обоих. В таких ситуациях AppsFlyer может выполнять атрибуцию, используя механизм агрегированной атрибуции, основанной на дифференцированной конфиденциальности (Aggregated Advanced Privacy) и вероятностное моделирование.

[Рекомендация] Чтобы повысить точность атрибуции, отправляйте все указанные параметры.

1. Добавьте следующие параметры к URL-адресу клика:

   Идентификатор	Параметр клика	Пример
   Кампания	c	US_20_30
   ID кампании	af_c_id	12345
   Блок рекламы	af_adset	ADSET_1
   ID блока рекламы	af_adset_id	56789
   Реклама	af_ad	nazvanie_kreativa
   ID рекламы.	af_ad_id	34567
   ID сайта	af_siteid	abcdefgh12345678
   ID субсайта	af_sub_siteid	abcdefgh12345678
   Канал	af_channel	nazvanie_kanala
   Тип рекламного объявления	af_ad_type	Видео
   Модель устройства iOS*	af_model	Модель устройства. Возможные значения: iphone (все строчные буквы) ipad (все строчные буквы)
   Операционная система*	af_os	Версия операционной системы
   *Некоторая информация также может предоставляться через агент пользователя. В этом случае значение, отправленное с использованием определенного идентификатора, имеет приоритет.

   
   Добавление сведений о кампании к URL-адресу клика

   В следующем примере показано, как добавить сведения о кампании к URL-адресу клика:

   https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId}

2. Добавьте следующие обязательные параметры в URL-адрес клика*:
   
   

    Внимание

   Если URL-адрес клика не передает обязательные параметры, вам не будет засчитана большая часть принесенных вами установок.

   • IP 
   • User-agent 

   *Никаких действий не требуется, если клик отправляется с помощью простого реферера HTTP, который перенаправляет в AppsFlyer. 

   Используйте описанный метод извлечения, чтобы добавить параметры к URL-клика при использовании любого из следующих методов: 

   • Перенаправление через приложение 
   • Межсерверные клики (S2S) 

   Параметры для атрибуции в режиме расширенной конфиденциальности

   Параметр	Обязательно/Не обязательно	Метод извлечения
   Язык и локаль устройства af_lang	Нет	NSString *language = [[NSLocale preferredLanguages] objectAtIndex:0]; [Рекомендуется] Укажите язык и локаль; например, en-US.
   Агент пользователя af_ua	Да	Извлеките user-agent в формате: Mozilla%2F5.0+%28iPhone%3B+CPU+iPhone+OS+13_3_1 +like+Mac+OS+X%29 AppleWebKit%2F605.1.15+%28KHTML%2C +like+Gecko%29+Mobile%2F15E148 Извлеките НЕ user-agent CFNetwork, а другой.  User-agent должен быть закодирован в URL.
   IP-адрес устройства af_ip	Да	Лучший вариант: если возможно, укажите IP-адрес устройства в параметре af_ip. Следующий вариант: если возможно, AppsFlyer будет использовать IP-адрес из X-Forwarded-For.

   
   Добавление параметров к URL-адресу клика

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

   https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad-type}&af_siteid={PublisherId}&af_ua={USER-AGENT}&af_lang={LANGUAGE}&af_ip={IP}

   Пример

   GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID} &af_ad_type={Ad type}&af_siteid={PublisherId} &af_ua=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2012_1_4%20 like%20Mac%20OS%20X%29%20AppleWebKit% 2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F16D57&af_lang=en-US&af_ip=11.11.1.11

   *Параметры запроса должны быть закодированы в URL.

   Передача данных о заголовках URL-адреса клика

   Чтобы передать поля заголовка URL-адреса клика, используйте следующую схему:

   GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId} accept-language: en-US,en;q=0. User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 13_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 X-Forwarded-For: 11.11.1.11, 222.222.2.222

Чтобы получать постбэки в режиме расширенной конфиденциальности, помимо обычной интеграции постбэков, необходимо настроить интеграцию Advanced Privacy. Вы можете настроить постбэк в режиме расширенной конфиденциальности самостоятельно на дэшборде AppsFlyer.

Различия между обычным шаблоном и шаблоном Advanced Privacy

• Постбэки отправляются партиями раз в час.
  • В партию включаются все типы событий.
  • В партию включаются и постбэки об атрибуции, и постбэки с отказом.
  • 0,001% постбэков может отправляться в более поздних партиях с задержкой до 24 часов.
• Время постбэка не коррелирует с фактическим временем события.
• Макросы меток времени:
  • Для установок и внутренних событий приложения метки времени округляются в меньшую сторону до часа, в котором они произошли. Например, 22:55:30 указывается в отчете как 22:00:00.
  • Регистрируются по часовому поясу UTC. Пример метки времени: (2020-07-20 20:00:00)
• Следующие параметры недоступны в постбэках в режиме расширенной конфиденциальности: ID клика, ID клиента, AppsFlyer ID, IDFA, IDFV, модель устройства, версия ОС, оператор связи.

Действия, которые рекламная сеть должна выполнить для интеграции:

1. Настроить постбэк в режиме расширенной конфиденциальности на дэшборде AppsFlyer. 
2. Протестировать интеграцию Advanced Privacy.

Конечная точка постбэка Advanced Privacy [заполните по мере необходимости]

Доступен макрос атрибуции в режиме расширенной конфиденциальности

Настройте постбэк AP в разделе управления постбэками на дэшборде AppsFlyer.

Необходимые условия:

• Чтобы управлять постбэками в режиме расширенной конфиденциальности, у вас должна быть активная интеграция с AppsFlyer. Свяжитесь с нами через виджет помощи партнерам, чтобы создать интеграцию.
• Управление постбэками выполняется администратором аккаунта; у членов команды нет соответствующего доступа.

Чтобы настроить постбэк:

1. Щелкните выпадающее меню в правом верхнем углу и выберите Postback management (Управление постбэками).
2. Выберите тип постбэка: Advanced Privacy. 
3. Активируйте конструктор.
   

   

4. Введите адрес конечной точки: URL-адрес конечной точки, на который AppsFlyer будет отправлять постбэки. Введите действительные URL-адреса для установок и/или внутренних событий приложения.
5. Введите параметры, которые требуется включать в постбэки:
   • Имя параметра: экранное имя параметра AppsFlyer
   • Получаемый параметр: соответствующий параметр, получаемый на вашей стороне
   • Значение параметра (доступно для некоторых параметров): выберите формат значения. Например, «истина/ложь» или «1/0» для логических значений.
   • Установка: установите флажок, чтобы включить параметр в постбэк установки.
   • Внутреннее событие: установите флажок, чтобы включить параметр в постбэк внутреннего события приложения.

   

   Полный список макросов, поддерживаемых в постбэках в режиме расширенной конфиденциальности.

6. [Необязательно] Добавьте свои параметры, которые не предоставляются AppsFlyer:

   

7. Откройте превью окончательного шаблона постбэка, чтобы убедиться, что все верно.

   

8. Нажмите Сохранить. Обратите внимание, что при сохранении постбэка изменения сразу вступают в силу.

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

Партнерам по аналитике постбэки отправляются следующим образом:

• AP выкл.: постбэк с данными уровня пользователя без ограничений.
• AP вкл.: с учетом источника, из которого пришел пользователь, и статуса ATT, как описано в данной таблице; 

Тип постбэка для партнера по аналитике с учетом статуса ATT и источника, из которого пришел пользователь

SKAdNetwork — это технология атрибуции, предоставляемая Apple для устройств iOS. Режим расширенной конфиденциальности (Advanced Privacy) — это часть фреймворка AppsFlyer Aggregated Advanced Privacy (AAP), которая относится к атрибуции, выполняемой AppsFlyer. AAP дает рекламодателям возможность контролировать доступность данных атрибуции, предоставляемых через платформу AppsFlyer. Как правило, рекламные сети поддерживают интеграцию как с AP, так и со SKAdNetwork.