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

Краткий обзор. Обмен данными с партнерами в режиме расширенной конфиденциальности. Инструкции для рекламных сетей по настройке постбэков в режиме расширенной конфиденциальности. Внимание! Эта статья не относится к постбэкам SKAdNetwork и не предназначена для рекламодателей. 

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

Описанный в этой статье механизм постбэков в режиме расширенной конфиденциальности работает при соблюдении всех следующих условий:

  • Устройство пользователя под управлением iOS 14.5+
  • Режим расширенной конфиденциальности включен

AdvancedPrivacy.png

Основные темы статьи: 

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

Начиная с iOS 14.5+, фреймворк AppsFlyer Aggregated Advanced Privacy (AAP) дает возможность рекламодателям контролировать доступность данных атрибуции уровня пользователя, предоставляемых через платформу AppsFlyer. 

В контексте рекламных сетей, фреймворк AAP реализуется с использованием режима расширенной конфиденциальности (Advanced Privacy, AP). Термины режим расширенной конфиденциальности, Advanced Privacy и AP используются в этой статье как синонимы. 

AP не влияет на доступность агрегированных данных для партнеров и рекламных сетей.  

На какие данные влияет AP

Когда режим AP включен, по пользователям iOS 14.5+, не давшим согласие, данные уровня пользователя не предоставляются через постбэки или иные способы получения отчетов, включая отчеты Protect360, связанные с мошенничеством.

В контексте постбэков это означает, что тип используемого постбэка зависит от того, дал ли пользователь согласие на ATT, и других факторов. 

Текущие настройки режима AP для каждого приложения можно просмотреть на дэшборде AppsFlyer. Перейдите в раздел Configuration (Настройки) > Integrated Partners (Интегрированные партнеры), выберите нужную рекламную сеть и откройте вкладку Integration (Интеграция). По умолчанию режим включен. 

APforPartners2.png

Типы постбэков, необходимые для интеграции Advanced Privacy:

  • Обычный: существующий шаблон интеграции с AppsFlyer. Содержит макросы user-identifier и attribution-data.
  • Режим расширенной конфиденциальности: шаблон без макроса user-identifier. Если требуется постбэк AP, а вы не завершили интеграцию AP, постбэк не отправляется. Настроить интеграцию AP можно самостоятельно с помощью нашего инструмента для управления постбэками.

Внимание! Если пользователь дал согласие на ATT и в приложении рекламодателя, и в приложении издателя («двойное согласие»), обычные постбэки отправляются как атрибутированным, так и неатрибутированным рекламным сетям.  

Используемый тип постбэка 

Следующая таблица актуальна для данных пользователей iOS 14.5+.

Внимание! Для iOS 14.4 и более ранних версий следующая таблица неприменима. Это значит, что постбэки на основе обычного шаблона отправляются как в атибутированную, так и в неатибутированную рекламную сеть. 

Статус AP

Статус ATT Тип шаблона постбэка для атрибутированного партнера*, поддерживающего AP  Тип шаблона постбэка для атрибутированного партнера*, не поддерживающего AP   Постбэк для неатрибутированного партнера*

Приложение издателя

Приложение рекламодателя

On

Авторизовано

Не авторизовано

Шаблон AP

Без постбэка

Нет

On

Не авторизовано

Авторизовано

Шаблон AP

Без постбэка

Обычный шаблон. Поля атрибуции недоступны.*

On

Авторизовано

Авторизовано

Обычный шаблон. Включает доступные идентификаторы, такие как IDFA, IDFV, CUID, ID клика и поля атрибуции. 

Обычный шаблон. Включает доступные идентификаторы, такие как IDFA, IDFV, CUID, ID клика и поля атрибуции.  Обычный шаблон с доступными идентификаторами. Поля атрибуции недоступны.*

On

Не авторизовано

Не авторизовано

Шаблон AP

Без постбэка

Нет

Откл.

Не учитывается

Не учитывается

Обычный

Обычный

Обычный шаблон. Поля атрибуции недоступны.*

Тип постбэка для iOS 14.5+

(*) Принципы обмена данными с партнерами

По каждому конкретному событию право на получение постбэка могут иметь сразу несколько партнеров — рекламных сетей. Постбэки отправляются следующим образом:

  • Атрибутированный партнер: рекламная сеть, которой засчитано событие
  • Неатрибутированный партнер: интегрированный партнер, которому событие не засчитано, когда в разделе In-app events postback (Постбэк по внутреннему событию) в качестве Sending option (Вариант отправки) задано значение All media sources including organic (Все медиа-источники, включая органические). Если для приложения рекламодателя есть согласие на ATT, постбэк содержит идентификаторы пользователя без данных атрибуции. (Этот вариант поддерживается не всеми рекламными сетями.)

    InAppEventAll.png

Веб-кампании

AP действует иначе, когда рекламная сеть показывает рекламу в вебе.

Чтобы указать, откуда пришел клик — из веба или из приложения, — в URL-адресе клика передается параметр af_media_type=web или af_media_type=app.

Если параметр af_media_type не передается, значение по умолчанию — app.

Статус ATT Тип постбэка для атрибутированного партнера* Тип постбэка для неатрибутированного партнера*

Приложение издателя

Приложение рекламодателя

Не авторизовано

Расширенные настройки конфиденциальности

Нет

Авторизовано

Обычный. Данные уровня пользователя с идентификаторами IDFA, IDFV, CUID, ID клика.

Обычный. Только идентификаторы уровня пользователя.

Тип постбэка, используемый для iOS 14.5+, когда режим AP включен

Интеграция

Обновите URL-адреса кликов и завершите интеграцию Advanced Privacy.

Требования к URL-адресу клика

Во многих случаях, в зависимости от наличия согласия пользователя на 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 [заполните по мере необходимости]

Макрос в постбэке (название)

Примечания Базовые параметры для всех постбэков Дополнительные параметры для внутренних событий приложения  Дополнительные параметры для отклоненной атрибуции
af_ad Имя креатива Да    
af_ad_id 34567 Да    
af_ad_type Например, баннер, футер, видео Да    
af_adset ADSET_1 Да    
af_adset_id 56789 Да    
app_id - Да    
app_name - Да    
attributed_touch_hour

Округляется в меньшую сторону до ближайшего часа. 

См. примечание по формату (1)

Да    
attributed_touch_type Например, клик, показ Да    
blocked_reason Связано с правилами валидации / Protect360     Да
blocked_reason_value Связано с правилами валидации / Protect360     Да
blocked_sub_reason Связано с правилами валидации / Protect360     Да
bundle_id Как задано рекламодателем Да    
c Название кампании, например, US_20_30 Да    
af_c_id Идентификатор кампании, например, 12345 Да    
af_channel Имя канала Да    
country_code ISO-код страны, зафиксированный при конверсии Да    
event_hour

Округляется в меньшую сторону до ближайшего часа. 

См. примечание по формату (1)

Да    
event_name Переданный приложением   Да  
event_revenue Сумма дохода в валюте события   Да  
event_revenue_
currency
Код валюты дохода   Да  
event_revenue_usd Доход в долларах США   Да  
install_hour

Округляется в меньшую сторону до ближайшего часа. 

Формат: см. примечание (1)

Да    
is_first Истинно, если данное событие в приложении было впервые инициировано определенным конечным пользователем   Да  
is_primary

Используется для удаления дубликатов

Логическое значение: 0, 1

  Да  
is_retargeting

Используется для удаления дубликатов 

Формат: см. примечание (2)

Да    
is_reengagement

Формат: см. примечание (2)

  Да  
is_reattribution

Используется для удаления дубликатов 

Формат: см. примечание (2)

Да    
match_type Примеры: id_matching, probabilistic Да    
event_id Имя/идентификатор соответствующего события на платформе рекламной сети   Да  
platform Например, iOS, Android Да    
postback_id Уникальный идентификатор постбэка Да    
retargeting_
conversion_type
Например, повторное вовлечение, реатрибуция Да    
af_siteid abcdefgh12345678 Да    
af_sub_siteid abcdefgh12345678 Да    

ПРИМЕЧАНИЯ

(1) Доступные форматы меток времени:

  • [По умолчанию] строка: YYYY-MM-DD HH:MM:SS
  • Unix-время: 10-значная метка времени Unix 

(2) Доступен логический формат

  • [По умолчанию] числовой: 0, 1 
  • Строка: false, true
Доступен макрос атрибуции в режиме расширенной конфиденциальности

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

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

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

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

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

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

    postback-management-enter-endpoint_en-us.png

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

    postback-management-parameters_en-us.png

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

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

    postback-management-custom-parameters_en-us.png

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

    postback-management-template_en-us.png

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

Если возникнут проблемы, пишите нам на адрес integrations@appsflyer.com.

Дополнительные сведения

AP для партнеров по аналитике

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

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

Источник, из которого пришел пользователь

Статус ATT Тип постбэка для партнера по аналитике

Приложение издателя

 Приложение рекламодателя

Неорганические 


 


 

Авторизовано

Авторизовано

Обычный

Не авторизовано

Авторизовано

Нет

Любое значение

Не авторизовано

Нет

Органический или веб

Авторизовано

Обычный

Органический или веб

Не авторизовано

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

AP vs. SKAdNetwork

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

Была ли эта статья полезной?