Новости о режиме расширенной конфиденциальности для рекламных сетей
Описанный в этой статье механизм постбэков в режиме расширенной конфиденциальности работает при соблюдении всех следующих условий:
- Устройство пользователя под управлением iOS 14.5+
- Режим расширенной конфиденциальности включен
Основные темы статьи:
- Влияние обмена данными в режиме расширенной конфиденциальности на партнеров.
- Требования к URL-адресу клика, пригодному для атрибуции.
- Настройка постбэков в режиме расширенной конфиденциальности на дэшборде AppsFlyer.
- Разница между режимом расширенной конфиденциальности и SKAdNetwork.
Принципы обмена данными в режиме расширенной конфиденциальности для рекламных сетей
Начиная с 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. Перейдите в Настройки > Активные интеграции > выберите вашу рекламную сеть > вкладка Интеграция. По умолчанию режим включен.
Типы шаблонов для отправки постбэков
- Обычный шаблон: имеющийся шаблон интеграции с 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, постбэк содержит идентификаторы пользователей без данных атрибуции. (Этот вариант поддерживается не всеми рекламными сетями.)
Веб-кампании
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) и вероятностное моделирование.
[Рекомендация] Чтобы повысить точность атрибуции, отправляйте все указанные параметры.
-
Добавьте следующие параметры к 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} -
Добавьте следующие обязательные параметры в 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/15E148X-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, модель устройства, версия ОС, оператор связи.
Действия, которые рекламная сеть должна выполнить для интеграции:
- Настроить постбэк в режиме расширенной конфиденциальности на дэшборде AppsFlyer.
- Протестировать интеграцию 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) Доступные форматы меток времени:
(2) Доступен логический формат
| ||||
Настройка постбэка в режиме расширенной конфиденциальности
Настройте постбэк AP в разделе управления постбэками на дэшборде AppsFlyer.
Необходимые условия:
- Чтобы управлять постбэками в режиме расширенной конфиденциальности, у вас должна быть активная интеграция с AppsFlyer. Свяжитесь с нами через виджет помощи партнерам, чтобы создать интеграцию.
-
Управление постбэками выполняется администратором аккаунта; у членов команды нет соответствующего доступа.
Чтобы настроить постбэк:
- Щелкните выпадающее меню в правом верхнем углу и выберите Postback management (Управление постбэками).
- Выберите тип постбэка: Advanced Privacy.
-
Активируйте конструктор.
- Введите адрес конечной точки: URL-адрес конечной точки, на который AppsFlyer будет отправлять постбэки. Введите действительные URL-адреса для установок и/или внутренних событий приложения.
-
Введите параметры, которые требуется включать в постбэки:
- Имя параметра: экранное имя параметра AppsFlyer
- Получаемый параметр: соответствующий параметр, получаемый на вашей стороне
- Значение параметра (доступно для некоторых параметров): выберите формат значения. Например, «истина/ложь» или «1/0» для логических значений.
- Установка: установите флажок, чтобы включить параметр в постбэк установки.
- Внутреннее событие: установите флажок, чтобы включить параметр в постбэк внутреннего события приложения.
Полный список макросов, поддерживаемых в постбэках в режиме расширенной конфиденциальности.
-
[Необязательно] Добавьте свои параметры, которые не предоставляются AppsFlyer:
-
Откройте превью окончательного шаблона постбэка, чтобы убедиться, что все верно.
- Нажмите Сохранить. Обратите внимание, что при сохранении постбэка изменения сразу вступают в силу.
Если возникнут проблемы, свяжитесь с нами через виджет помощи партнерам.
Дополнительные сведения
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.