How can we help?

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

  • Обновлено
Краткий обзор. Обмен данными с партнерами в режиме расширенной конфиденциальности. Инструкции для рекламных сетей по настройке постбэков в режиме расширенной конфиденциальности. Внимание! Эта статья не относится к постбэкам 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 включен, данные, которые клиенты могут предоставлять через постбэки или другими методами отчетности, предоставляются только в агрегированном виде. Когда режим AP включен, по пользователям iOS 14.5+, не давшим согласие, данные уровня пользователя не предоставляются через постбэки или иные способы получения отчетов, включая отчеты Protect360, связанные с мошенничеством.

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

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

APforPartners2.png

Типы шаблонов для отправки постбэков

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

 Примечание

  • Если пользователь дал согласие на ATT и в приложении рекламодателя, и в приложении издателя («двойное согласие»), обычные постбэки отправляются как атрибутированным, так и неатрибутированным рекламным сетям.
  • Исключение. Для установок, атрибутированных к Apple Search Ads (ASA), ASA отправляет постбэки по установкам в рекламную сеть, даже если для рекламодателя включена функция расширенной конфиденциальности, в следующих случаях:
    • Не авторизовано
    • Постбэки по установкам в рекламной сети установлены на Все медиа-источники и органический трафик
    • Рекламная сеть не поддерживает режим расширенной конфиденциальности.

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

В следующей таблице описаны типы постбэков в зависимости от доступности идентификатора рекламодателя и статуса расширенной конфиденциальности.

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

Статус AP Статус ATT Тип шаблона постбэка для атрибутированного партнера*, поддерживающего AP  Тип шаблона постбэка для атрибутированного партнера*, не поддерживающего AP  Постбэк для неатрибутированного партнера*
Приложение издателя Приложение рекламодателя
Включен доступно Не авторизовано Шаблон AP (агрегированные данные) Без постбэка Ничего
Включен Не авторизовано доступно Шаблон AP (агрегированные данные) Без постбэка

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

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

Включен доступно доступно Обычный шаблон. Включает доступные идентификаторы, такие как IDFA, IDFV, CUID, ID клика и поля атрибуции.  Обычный шаблон. Включает доступные идентификаторы, такие как IDFA, IDFV, CUID, ID клика и поля атрибуции.  Обычный шаблон с доступными идентификаторами. Поля атрибуции недоступны.*
Включен Не авторизовано Не авторизовано Шаблон AP (агрегированные данные) Без постбэка Ничего
Откл. Не учитывается Не учитывается Обычный шаблон. Обычный шаблон.

Обычный шаблон.

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

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

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

  • Атрибутированный партнер: рекламная сеть, которой засчитано событие
  • Неатрибутированный партнер: интегрированный партнер, которому событие не засчитано, когда в разделе 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.

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

Статус ATT Тип постбэка для атрибутированного партнера* Тип постбэка для неатрибутированного партнера*
Приложение издателя Приложение рекламодателя
Нет Авторизовано Расширенные настройки конфиденциальности Ничего
Нет Авторизовано Обычный. Данные уровня пользователя с идентификаторами IDFA, IDFV, CUID, ID клика. Обычный. Только идентификаторы уровня пользователя.

Интеграция

Обновите 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
    Идентификатор 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 
    • Агент пользователя 

    *Никаких действий не требуется, если клик отправляется с помощью простого реферера 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

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

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

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

Да    
attributed_touch_type (атрибутированный тип взаимодействия) Например, клик, показ Да    
заблокированная_причина Связано с правилами валидации / Protect360     Да
заблокированное_значение_причины Связано с правилами валидации / Protect360     Да
заблокированная_подпричина Связано с правилами валидации / Protect360     Да
Авторизовано Как задано рекламодателем Да    
c Название кампании, например, US_20_30 Да    
af_c_id Идентификатор кампании, например, 12345 Да    
af_channel Имя канала Да    
код_страны ISO-код страны, зафиксированный при конверсии Да    
event_hour

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

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

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

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

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

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

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

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

  Да  
is_retargeting

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

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

Да    
is_reengagement Формат: см. примечание (2)   Да  
Авторизовано

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

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

Да    
Местоположение устройства Примеры: id_matching, probabilistic Да    
Доход, связанный с SKU, в валюте, указанной в поле event_revenue_currency. Имя/идентификатор соответствующего события на платформе рекламной сети   Да  
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. Свяжитесь с нами через виджет помощи партнерам, чтобы создать интеграцию.
  • 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. Нажмите Сохранить. Обратите внимание, что при сохранении постбэка изменения сразу вступают в силу.

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

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

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

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

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

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

Источник, из которого пришел пользователь ID рекламы. Тип постбэка для партнера по аналитике
Приложение издателя  Приложение рекламодателя

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


 

 


 

 

доступно доступно Обычный
Не авторизовано доступно Ничего
Любое значение Не авторизовано Ничего
Органический или веб Нет доступно Обычный
Органический или веб Нет Не авторизовано Ничего

AP vs. SKAdNetwork

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

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: