Проверьте релевантность рекламы в Privacy Sandbox и API-интерфейсы измерения.

Privacy Sandbox включает в себя набор предложений, позволяющих использовать рекламные варианты без необходимости межсайтового отслеживания. Пробные версии Origin дают разработчикам возможность оценить и оставить отзыв о новых веб-технологиях посредством тестирования в реальных условиях. В предыдущих испытаниях происхождения сайты могли тестировать отдельные API. Для API-интерфейсов Topics, FLEDGE и Attribution Reporting мы предоставляем единую пробную версию , которая позволяет сайтам проводить унифицированные эксперименты с API-интерфейсами, составляющими начальную версию сквозного жизненного цикла рекламы. API доступны для тестирования в Chrome 101 Beta и более поздних версиях. В бета-версии Chrome 101 также обновлены пользовательские элементы управления, поскольку мы продолжаем работать над параметрами конфигурации.

Как разработчик вы сможете подписаться на эту пробную версию для одного источника, которая позволит вам протестировать API-интерфейсы Topics, FLEDGE и Attribution Reporting. В этом руководстве вы пройдете этапы настройки для доступа к API, объясните, как проверить вашу конфигурацию, и предоставите дополнительные ресурсы для тестирования API.

Что входит в исходную пробную версию?

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

  • Темы для просмотра и доступа к темам браузера через document.browsingTopics() .
  • FLEDGE для управления группами интересов браузера, а также назначением ставок и выбором рекламы на основе этих групп и других сигналов.
    • В этой исходной пробной версии FLEDGE доступен на настольном компьютере и включает в себя определенное подмножество всех предлагаемых функций. Для получения дополнительной информации прочтите подробности пробного испытания FLEDGE .
  • Огражденные фреймы для отображения непрозрачного URL-адреса победителя рекламного аукциона FLEDGE .
  • Отчеты по атрибуции для измерения и составления отчетов об эффективности на протяжении жизненного цикла рекламы.
    • В рамках отчетности по атрибуции агрегированные отчеты должны обрабатываться и агрегироваться службой агрегирования для создания сводных отчетов. В ближайшее время мы опубликуем дополнительные инструменты и руководства для местного и исходного пробного тестирования.
    • Если вы участвовали в предыдущих пробных версиях отчетов по атрибуции, имейте в виду, что вам необходимо будет выполнить встроенное обновление с учетом последних изменений API. Подробную информацию см. в руководстве по миграции .

Хотя эта настройка позволяет проводить унифицированное тестирование всех этих API, вы можете выбирать, какие аспекты реализовать — в зависимости от ваших потребностей.

Как разработчикам подписаться на пробную версию Origin?

Зарегистрируйтесь для участия в пробной версии Privacy Sandbox Relevance and Measurement . С помощью следующих HTML-тегов предоставьте пробный токен на каждой странице, на которой вы хотите запустить код API:

  • Тег <meta> в разделе <head> страницы верхнего уровня: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
  • HTTP-заголовок в ответе страницы верхнего уровня: Origin-Trial: TOKEN_GOES_HERE

Некоторые функции, доступные в исходной пробной версии, предназначены для использования в межсайтовом контексте, например, когда вы предоставляете услугу в качестве стороннего поставщика на сайте верхнего уровня. Если вам нужно включить пробную версию источника для этих дополнительных контекстов, убедитесь, что вы выбрали опцию «Стороннее сопоставление» . Чтобы включить исходную пробную версию из стороннего JavaScript, добавьте тег <meta> на страницу верхнего уровня (т. е. на первую страницу, а не на свой собственный контент) из вашего скрипта. Например:

const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

Подробную информацию можно найти в руководстве по началу работы с пробными версиями Chrome Origin .

Как разработчики проводят локальное тестирование?

Индивидуальная документация для разработчиков по темам , FLEDGE и отчетам об атрибуции содержит конкретные рекомендации по тестированию локальных разработчиков для каждого API. API-интерфейсы не включены по умолчанию, и их необходимо включить с помощью флагов для тестирования.

Чтобы включить API для тестирования, необходимо:

  • Используйте Chrome 101 Beta или более позднюю версию .
    • Для FLEDGE требуется настольный Chrome.
    • API недоступны в версиях Chrome для iOS.
  • Включите API, используя флаг chrome://flags/#privacy-sandbox-ads-apis .
    • Этот флаг принудительно включает API для упрощения тестирования. Если вы хотите реплицировать подходящего исходного пробного пользователя, у которого его дополнительные настройки все еще могут отключать API, вам следует запустить Chrome с использованием флагов CLI: --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs .
    • Отдельные API могут иметь больше дополнительных флагов для более детальной настройки. Подробную информацию можно найти в отдельных руководствах.
    • Дополнительные флаги могут конфликтовать с этим, поэтому рассмотрите возможность установки только этого флага, если у вас возникнут проблемы.
  • Включите пробные версии Privacy Sandbox в настройках Chrome: Настройки > Безопасность и конфиденциальность > Privacy Sandbox . Это также доступно по адресу chrome://settings/adPrivacy .
  • Включите сторонние файлы cookie в настройках Chrome: Настройки > Безопасность и конфиденциальность . Установите для файлов cookie и других данных сайта значение «Разрешить все файлы cookie» или «Блокировать сторонние файлы cookie в режиме инкогнито». Это также доступно по адресу chrome://settings/cookies .
  • Будьте в стандартном сеансе просмотра. Не используйте режим инкогнито.

Как разработчики проверяют, правильно ли настроена пробная версия Origin?

Устранение неполадок исходных пробных версий Chrome содержит подробный контрольный список для проверки конфигурации исходной пробной версии.

DevTools показывает статус пробной версии источника в разделе «Приложения»

DevTools отображает статус исходной пробной версии на вкладке «Приложения» в разделе «Кадры».

Хотя пробная версия Origin будет отображаться как активная только для соответствующих пользователей , как описано ниже, вы также можете использовать флаги разработчика для тестирования на своем собственном рабочем сайте.

Какие пользователи имеют право на участие в пробной версии Origin?

По замыслу пробные версии Origin предназначены для запуска только небольшой части общего трафика Chrome , и поэтому вы всегда должны предполагать, что даже если вы включили пробную версию Origin на своем сайте, у пользователя может не быть активного API . Активная экспериментальная группа в исходном испытании начнется с небольшой доли пользователей и, вероятно, будет увеличиваться по мере прохождения испытания. Имейте в виду, что процент пользователей Chrome в эксперименте может не совпадать с процентом активных пользователей на вашем сайте.

Однако, чтобы обеспечить единое тестирование на всех сайтах, этот набор подходящих пользователей должен оставаться в основном одинаковым. Например, если пользователь имеет право на участие в пробной версии Origin при просмотре рекламы на сайте участвующего издателя, этот же пользователь все равно должен иметь право на участие в пробной версии, когда он совершает конверсию на сайте участвующего рекламодателя.

Чтобы пользователь имел право на участие, он должен:

  • использовать Chrome 101 Beta или более позднюю версию .
    • Для FLEDGE требуется настольный Chrome.
    • в версиях Chrome для iOS недоступны пробные версии Origin.
  • просматривать в течение пробного периода активного источника .
  • Включите пробные версии Privacy Sandbox в разделе «Настройки» > «Безопасность и конфиденциальность» > «Privacy Sandbox», который также доступен через chrome://settings/adPrivacy .
  • Включите сторонние файлы cookie в разделе «Настройки» > «Безопасность и конфиденциальность» > «Файлы cookie и другие данные сайта», установите значение «Разрешить все файлы cookie» или «Блокировать сторонние файлы cookie в режиме инкогнито», что также доступно через chrome://settings/cookies .
  • находиться в стандартном сеансе просмотра, а не в режиме инкогнито .
  • быть в активной экспериментальной группе в Chrome .

Как разработчикам следует обнаруживать поддержку API?

Как и в случае с любой функцией веб-платформы, перед ее использованием необходимо обнаружить поддержку этой функции.

Темы

Проверьте наличие функции browsingTopics() в document и Политики разрешений](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature) для «browsing-topics».

if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
  // Topics enabled
}

ФЛЕДЖ

Если вы хотите присоединиться к группе по интересам к рекламе, проверьте функцию joinAdInterestGroup в navigator и политику разрешений для «join-ad-interest-group».

if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
  // FLEDGE interest group enabled
}

Если вы хотите провести аукцион, проверьте наличие функции runAdAuction в navigator и политику разрешений для «run-ad-auction».

if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
  // FLEDGE auction enabled
}

Отчеты по атрибуции

Проверьте наличие объекта attributionReporting в window и политику разрешений для «attribution-reporting».

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting API enabled
}

Где разработчики могут оставить отзыв и получить поддержку?

На странице обзора отзывов подробно описаны различные способы отправки отзывов по различным аспектам Privacy Sandbox. Существуют специальные разделы « Темы» , «FLEDGE» и «Отчеты об атрибуции» , в которых представлены отдельные ссылки для каждого API.

Мы также предоставляем регулярные обновления серии «Прогресс в Privacy Sandbox», в которой содержится сводка важных новостей.