Privacy Sandbox включает в себя ряд предложений, позволяющих использовать рекламные сценарии без необходимости межсайтового отслеживания. Пробные версии Origin предоставляют разработчикам возможность оценивать новые веб-технологии и предоставлять обратную связь по ним посредством тестирования в реальных условиях. Пробная версия Privacy Sandbox Relevance and Measurement представляет собой единую пробную версию, позволяющую сайтам проводить унифицированные эксперименты с Attribution Reporting, Protected Audience API, Topics, Fenced Frames и Shared Storage. Разработчики могут зарегистрироваться в этой пробной версии, которая позволяет проводить тестирование с использованием Topics, Protected Audience API и Attribution Reporting API. Это руководство поможет вам настроить доступ к API, расскажет, как проверить конфигурацию, и предоставит дополнительные ресурсы для тестирования API.
Проверьте статус исходного судебного разбирательства
Июнь 2023 г.
Частное агрегирование: рост на 7% в стабильном режиме
API частного агрегирования будет доступен в 7% трафика Chrome Stable со вторника, 6 июня 2023 года. API будет доступен в основной унифицированной пробной группе (5%), изолированной группе «Защищённая аудитория» (1%) и изолированной группе «Общее хранилище» (1%). Распределение трафика для «Защищённой аудитории» и «Общего хранилища» не изменится, поскольку функция частного агрегирования добавляется к существующим изолированным экспериментам.
Распределение трафика по состоянию на вторник, 6 июня:
| API | Распределение трафика | Статус |
| Отчетность по атрибуции | Единый - 5% | 6% стабильного трафика по состоянию на 13 марта 2023 г. |
| Изолированный - 1% - только АРА | ||
| Огороженные рамы | Единый - 5% | 7% стабильного трафика по состоянию на 13 марта 2023 г. |
| Изолированный — 1% — общее хранилище + частное агрегирование + только изолированные фреймы | ||
| Изолированный - 1% - Защищенная аудитория + Частная агрегация + Только защищенные фреймы | ||
| Защищенная аудитория | Единый - 5% | 6% стабильного трафика по состоянию на 13 марта 2023 г. |
| Изолированный - 1% - Защищенная аудитория + Частная агрегация + Только защищенные фреймы | ||
| Частная агрегация | Единый - 5% | 7% стабильного трафика по состоянию на 6 июня 2023 г. |
| Изолированный - 1% - Защищенная аудитория + Частная агрегация + Только защищенные фреймы | ||
| Изолированный — 1% — общее хранилище + частное агрегирование + только изолированные фреймы | ||
| Общее хранилище | Единый - 5% | 6% стабильного трафика по состоянию на 13 марта 2023 г. |
| Изолированный — 1% — общее хранилище + частное агрегирование + только изолированные фреймы | ||
| Темы | Единый - 5% | 6% стабильного трафика по состоянию на 13 марта 2023 г. |
| Изолированные - 1% - Только темы |
Предыдущие обновления
Ознакомьтесь с предыдущими обновлениями по испытанию Origin.
Апрель 2023 г.
Частное агрегирование: рост на 1% в стабильном режиме
Пробная версия API частного агрегирования будет доступна в размере 1% от трафика унифицированного эксперимента Chrome Stable с понедельника 17 апреля. Функция sendHistogramReport() частного агрегирования доступна для использования в рабочих программах API защищенной аудитории и общего хранилища .
Распределение трафика будет выглядеть следующим образом, начиная с понедельника, 17 апреля:
| API | Распределение трафика | Статус |
| Отчетность по атрибуции | Единый - 5% | 6% от стабильного трафика с 13 марта 2023 г. |
| Изолированный - 1% - только АРА | ||
| Огороженные рамы | Единый - 5% | 7% от стабильного трафика с 13 марта 2023 г. |
| Изолированный - 1% - общее хранилище (выбор URL) + только защищенные фреймы | ||
| Изолированный - 1% - API защищенной аудитории + только защищенные фреймы | ||
| API защищенной аудитории | Единый - 5% | 6% от стабильного трафика с 13 марта 2023 г. |
| Изолированный - 1% - API защищенной аудитории + только защищенные фреймы | ||
| Частная агрегация | Единый - 1% | 1% от стабильного трафика с 17 апреля 2023 г. |
| Общее хранилище (выбор URL) | Единый - 5% | 6% от стабильного трафика с 13 марта 2023 г. |
| Изолированный - 1% - общее хранилище (выбор URL) + только защищенные фреймы | ||
| Темы | Единый - 5% | 6% от стабильного трафика с 13 марта 2023 г. |
| Изолированные - 1% - Только темы |
Март 2023 г.
Обновление временной шкалы
Изначально мы сообщали, что начнём отдельные эксперименты в понедельник, 13 марта 2023 года, но теперь новые эксперименты начнутся в четверг, 16 марта 2023 года, в связи с необходимостью дополнительного времени на их подготовку. Увеличение доли API 1% защищённой аудитории с 4% до 5% также произойдёт в четверг, 16 марта 2023 года.
Защищенный API Аудитории 1% наращивает темпы
В прошлом месяце мы временно сократили долю трафика Protected Audience API с 5% до 4% от трафика стабильной версии Chrome для тестирования. Первоначальное тестирование завершено, и мы планируем увеличить долю Protected Audience API с 4% до 5% для унифицированного эксперимента в четверг, 16 марта 2023 года.
Пользователи, которым будет предоставлен доступ, будут теми же, чьи возможности были ограничены. Однако их предыдущие группы интересов утратили силу, поскольку с момента ограничения доступа прошло более 30 дней.
Изолированные эксперименты
Чтобы улучшить процесс тестирования и продолжить наблюдение за метриками API-интерфейсов Origin, мы создаём изолированные эксперименты для каждого API в дополнение к существующему унифицированному эксперименту. Будут созданы новые эксперименты для отчётов об атрибуции, тем, комбинации API защищенной аудитории и огороженных фреймов, а также комбинации операции выбора URL-адресов в общем хранилище и огороженных фреймов. В каждом изолированном эксперименте пользователям этой группы будут доступны только назначенные API.
| API | Изолированный эксперимент распределение трафика |
|---|---|
| Отчетность по атрибуции | 1% |
| API защищенной аудитории + защищенные фреймы | 1% |
| Общее хранилище (выбор URL) + Защищенные фреймы | 1% |
| Темы | 1% |
С четверга, 16 марта, вы начнёте получать дополнительный 1% трафика стабильной версии Chrome для перечисленных выше API в дополнение к 5% трафика, получаемого в рамках текущего объединённого эксперимента. В каждый эксперимент будут добавлены новые пользователи.
Распределение трафика
Текущее распределение трафика в рамках испытаний единого источника по состоянию на вторник, 28 февраля, выглядит следующим образом:
| API | Текущий объединенный эксперимент распределение трафика |
|---|---|
| Отчетность по атрибуции | 5% |
| Огороженные рамы | 5% |
| API защищенной аудитории | 4% |
| Общее хранилище (выбор URL) | 5% |
| Темы | 5% |
Распределение трафика будет выглядеть следующим образом, начиная с четверга, 16 марта, после того как API защищенной аудитории снова заработает и начнутся новые изолированные эксперименты:
| API | Новое распределение трафика | Статус |
|---|---|---|
| Отчетность по атрибуции | Единый - 5% | 6% от стабильного трафика с 16 марта 2023 г. |
| Изолированный - 1% - только АРА | ||
| Огороженные рамы | Единый - 5% | 7% от стабильного трафика с 16 марта 2023 г. |
| Изолированный - 1% - общее хранилище (выбор URL) + только защищенные фреймы | ||
| Изолированный - 1% - API защищенной аудитории + только защищенные фреймы | ||
| API защищенной аудитории | Унифицированный - 5% (4% текущего распределения + 1% резервного финансирования) | 6% от стабильного трафика с 16 марта 2023 г. |
| Изолированный - 1% - API защищенной аудитории + только защищенные фреймы | ||
| Общее хранилище (Выбор URL) | Единый - 5% | 6% от стабильного трафика с 16 марта 2023 г. |
| Изолированный - 1% - общее хранилище (выбор URL) + только защищенные фреймы | ||
| Темы | Единый - 5% | 6% от стабильного трафика с 16 марта 2023 г. |
| Изолированные - 1% - Только темы |
Эти изменения не повлияют на настройку вашего существующего пробного токена Origin, и вам не придется обновлять или генерировать новый пробный токен Origin.
Январь 2023 г.
В рамках расследования регрессии Chrome мы временно сократим пробный трафик Protected Audience API с 5% до 4% от Chrome Stable с 26 января 2023 года. Мы предполагаем, что расследование займет около месяца, и мы уведомим вас, когда трафик снова возрастет.
Это изменение произойдет автоматически и не повлияет на ваши текущие пробные токены Origin. Для пользователей, чей трафик (1%) сократится, группы интересов останутся в браузерах. Те же пользователи будут участвовать в восстановлении трафика, и их группы интересов можно будет использовать повторно. Однако срок действия групп интересов истекает через 30 дней, а регрессионное исследование может занять больше времени.
Кроме того, с 26 января 2023 года пробная версия API выбора URL-адресов для общего хранилища увеличится до 5% трафика Chrome Stable.
| API | Примечания |
|---|---|
| Отчетность по атрибуции | Доступно в стабильной версии, увеличено до 5% с 26 октября 2022 г. |
| Темы | Доступно в стабильной версии, увеличено до 5% с 26 октября 2022 г. |
| API защищенной аудитории | Доступно в версии Stable, временное снижение до 4% с 26 января 2023 года. |
| Огороженные рамы | Доступно в стабильной версии, с повышением до 5% с 9 ноября 2022 г. |
| Общее хранилище | Доступно в версии Stable, с ростом на 5% с 26 января 2023 года. |
Ноябрь 2022 г.
API `selectURL` Shared Storage присоединится к пробной версии Origin и будет составлять 1% трафика Chrome Stable с 9 ноября.
Как было объявлено ранее в сообщении блога «Повышение релевантности и уровня измерения источника в Privacy Sandbox до 5%» , отчетность по атрибуции и темы теперь составляют 5%, а API защищенной аудитории и защищенные фреймы также появятся 9 ноября.
| API | Примечания |
|---|---|
| Отчетность по атрибуции | Доступно в стабильной версии, увеличено до 5% с 26 октября. |
| Темы | Доступно в стабильной версии, увеличено до 5% с 26 октября. |
| API защищенной аудитории | Доступно в стабильной версии, с 9 ноября скидка увеличится до 5%. |
| Огороженные рамы | Доступно в стабильной версии, с 9 ноября скидка увеличится до 5%. |
| Общее хранилище | Будет доступно в стабильной версии, начиная с 1% с 9 ноября. |
Октябрь 2022 г.: увеличение на 5%
Отчеты об атрибуции, темы, API защищенной аудитории и защищенные фреймы в настоящее время доступны в стабильной версии Chrome и будут использоваться в связи с возросшим трафиком.
С этой недели мы начнем увеличивать трафик для Attribution Reporting и Topics, а с 9 ноября — для Protected Audience API и Fenced Frames.
Подробнее читайте в записи блога «Повышение релевантности и уровня измерения источника в Privacy Sandbox до 5%» .
| API | Примечания |
|---|---|
| Отчетность по атрибуции | Доступно в стабильной версии, с увеличением до 5% после 26 октября. |
| Темы | Доступно в стабильной версии, с увеличением до 5% после 26 октября. |
| API защищенной аудитории | Доступно в стабильной версии, с 9 ноября скидка увеличится до 5%. |
| Огороженные рамы | Доступно в стабильной версии, с 9 ноября скидка увеличится до 5%. |
| Общее хранилище | На данный момент доступно только в версиях M105+ Canary, Dev и Beta. |
Октябрь 2022 г.
- Пробная версия Origin продлена до Chrome 110 .
- В статье «Начало работы с пробными версиями Chrome Origin» объясняется, как продлить регистрацию в пробной версии Origin. Это включает в себя предоставление нового токена участвующим версиям Origin. Эта процедура аналогична процедуре продления любой другой пробной версии Origin.
Это продление было предоставлено для того, чтобы дать экосистеме в стабильном канале время для продолжения тестирования и проверки улучшений API, одновременно предоставляя обратную связь в соответствии с нашим текущим публичным графиком.
Общая временная шкала Privacy Sandbox остается неизменной.
API, включенные в исследование:
| API | Примечания |
|---|---|
| Отчетность по атрибуции | Руководство разработчика для пробной версии Origin . |
| API защищенной аудитории | Руководство разработчика для пробной версии Origin . |
| Темы | Руководство разработчика для пробной версии Origin . |
| Огороженные рамы | Информацию об использовании пробной версии Origin см. в руководстве по API защищенной аудитории. |
| Общее хранилище | На данный момент доступно только в версиях M105+ Canary, Dev и Beta. |
Август 2022 г.
- Доступность пробной версии Origin увеличивается до 1% пользователей настольных компьютеров, начиная с Chrome Stable 104 .
- Обновления будут опубликованы, когда функция станет доступна и для мобильных пользователей.
- Предварительно стабильные каналы (Canary, Beta) остаются у 50% пользователей.
- API недоступны в iOS Chrome.
Май 2022 г.
Доступность пробной версии Origin увеличилась до 50% для пользователей Chrome 102 Beta .
API, включенные в исследование:
| API | Примечания |
|---|---|
| Отчетность по атрибуции | Руководство разработчика для пробной версии Origin . |
| API защищенной аудитории | Руководство разработчика для пробной версии Origin . |
| Темы | Руководство разработчика для пробной версии Origin . В пробной версии Origin темы были временно отключены из-за ошибки, которая повлияла на стабильность работы браузера. |
| Огороженные рамы | В исходную пробную версию добавлены фреймы Fenced Frames. Инструкции по использованию API Protected Audience см. в руководстве по эксперименту. |
Апрель 2022 г.
Пробный период Origin начнется с ограниченной доли пользователей Chrome 102 Beta .
API, включенные в исследование:
| API | Примечания |
|---|---|
| Отчетность по атрибуции | Индивидуальное намерение экспериментировать (I2E) – публикация. Отчёты об атрибуции также доступны в качестве индивидуального исследования происхождения. |
| API защищенной аудитории | Публикация «Индивидуальное намерение экспериментировать» (I2E) . API защищенной аудитории доступен только на настольных компьютерах с ограниченным набором функций . |
| Темы | Пост «Индивидуальное намерение экспериментировать» (I2E) . |
Зарегистрируйтесь и настройте пробную версию Origin
Чтобы активировать пробную версию Origin на своём сайте, вам необходимо зарегистрироваться и внедрить назначенный токен пробной версии Origin (строку с ограниченным сроком действия для вашего доступа к пробной версии Origin). Подробнее см. в статье «Начало работы с пробными версиями Origin в Chrome» .
Пробные токены Origin предоставляются немедленно, и вы можете отозвать их или создать заново в любое время.
Для каждой страницы, на которой вы хотите использовать пробную версию Origin, вам необходимо включить токен пробной версии в HTML-код или ответ этой конкретной страницы.
Используйте тег <meta> в разделе <head> страницы:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
В качестве альтернативы включите в ответ страницы следующий HTTP-заголовок:
Origin-Trial: TOKEN_GOES_HERE
Настроить с помощью iframe
Если вы используете пробные функции источника внутри iframe (например, joinAdInterestGroup() API защищенной аудитории), то токен должен быть предоставлен внутри iframe и соответствовать источнику iframe.
Настройте кросс-сайт с помощью JavaScript
Если вы используете пробные функции Origin через межсайтовый JavaScript, то есть вы являетесь поставщиком стороннего JavaScript, включаемого в страницу верхнего уровня, вам необходимо:
- При регистрации на пробную версию Origin выберите опцию «Стороннее сопоставление» .
- Поле «Web Origin» должно указывать источник вашего скрипта.
- Добавьте тег
<meta>из вашего скрипта на страницу верхнего уровня (то есть на первую страницу, а не на ваш собственный контент). Например:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
Отладка исходного пробного периода
Проверить статус пробной версии Origin можно на панели DevTools > Applications .
- Прокрутите вниз до панели «Рамки» .
- Выберите фрейм, в котором вы планируете установить токен. Например, верхний фрейм для страницы верхнего уровня или специальный iframe для встроенных страниц.
- В правой панели прокрутите вниз до раздела Origin Trials .
- Вы должны увидеть запись о пробной версии
PrivacySandboxAdsAPIs. - Разверните эту запись, чтобы увидеть статус пробной версии Origin и ваших токенов.
Пробная версия Origin доступна лишь ограниченному числу пользователей Chrome, и ваш браузер может не входить в экспериментальную группу. В результате вы можете увидеть красное сообщение TrialNotAllowed рядом с PrivacySandboxAdsAPIs . Если при разворачивании записи для проверки статуса токена отображается зелёное сообщение Success , это означает, что конфигурация пробной версии Origin верна. Пользователи, соответствующие требованиям, увидят сообщение Enabled .
Если вы видите другие сообщения, обратитесь к разделу Устранение неполадок с пробными версиями Origin в Chrome, где представлен подробный контрольный список для проверки конфигурации пробной версии Origin.
Обнаружение особенностей
Как и в случае со всеми веб-функциями, перед их использованием следует убедиться, что они доступны в браузере. Это можно сделать, проверив наличие соответствующего API в нужном месте:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting enabled
}
if ('runAdAuction' in navigator) {
// Protected Audience API enabled
}
if ('browsingTopics' in document) {
// Topics enabled
}
if ('HTMLFencedFrameElement' in window) {
// Fenced Frames enabled
}
if ('sharedStorage' in window) {
// Shared Storage enabled
}
if (window?.sharedStorage?.selectURL instanceof Function) {
// optionally check specifically for the selectURL function in Shared Storage
}
Определить право пользователя
Пробная версия Origin доступна лишь ограниченному числу пользователей Chrome. Для участия в ней необходимо включить соответствующие функции в настройках:
Настройки браузера
Чтобы пользователь имел право на участие в пробной версии, он должен:
Используйте версию и канал Chrome, на которых запущена пробная версия Origin.
- Актуальные конфигурации см. в разделе «Статус пробной версии Origin» .
Входить в активную экспериментальную группу в Chrome .
Настройки пользователя
Чтобы иметь право на участие в пробной версии, пользователь также должен:
- включите пробную версию Privacy Sandbox в разделе «Настройки» > «Безопасность и конфиденциальность» > «Privacy Sandbox», также доступном по адресу
chrome://settings/adPrivacy. - включите сторонние файлы cookie в разделе «Настройки» > «Безопасность и конфиденциальность» > «Файлы cookie и другие данные сайтов», установив значение «Разрешить все файлы cookie» или «Блокировать сторонние файлы cookie в режиме инкогнито», также доступное по адресу
chrome://settings/cookies. - находиться в стандартном сеансе просмотра, а не в режиме инкогнито .
Хотя исходная пробная версия будет отображаться как активная только для соответствующих пользователей, вы также можете использовать флаги разработчика для тестирования на своем собственном рабочем сайте.
Контролируйте свое участие в исследовании происхождения
Механизм пробного периода остается прежним: вы получаете пробные токены для тех контекстов, в которых хотите экспериментировать с API. В связи с расширением выборки участников тестирования вам следует активно отслеживать и контролировать объем трафика, на котором вы решили включить пробный период.
Хорошим подходом здесь будет:
- Включайте пробные токены Origin по умолчанию во все контексты, в которых вы хотите провести эксперимент.
- Используйте обнаружение функций для проверки активных API.
- Если API активны (и, следовательно, браузер подходит для этого эксперимента), выберите, использовать их или нет, исходя из собственных критериев эксперимента. Например, если у вас уже есть инфраструктура A/B-тестирования для экспериментов с процентом трафика, выборкой или каким-либо другим атрибутом, то на этом этапе вы можете решить, какие функции будете активно использовать.
Вы можете полностью запретить участие в тестовом режиме Origin для любого экземпляра браузера, не включая токен в ответ. Например, если вы исчерпали свою квоту для эксперимента или вам необходимо решить проблему в ходе тестирования, отсутствие токена гарантирует, что никакие экспериментальные функции на странице не будут доступны или активны.
Контроль происхождения по географическому региону
Вы не можете отказаться от пробной версии Origin для определённых регионов. Пробные версии Origin активны на страницах, содержащих токен , который добавляется через HTTP-заголовки (на стороне сервера) или метатеги HTML (на стороне клиента).
Если вы можете определить местоположение пользователя, то вы можете написать код для включения пробного токена Origin на основе этой информации. Например, вы можете попытаться определить местоположение пользователя по IP-адресам. IP-адреса могут быть подменены, поэтому это решение не гарантирует результата.
Однако для географически привязанного источника можно задать политику разрешений , контролирующую используемые функции. Например, us.example.com и uk.example.com — это географически привязанные источники, которыми можно управлять. Это не означает, что регион отказался от пробной версии источника.
С помощью политики разрешений сайт добавляет на свои страницы небольшой фрагмент кода, содержащий инструкции для браузера. При загрузке страницы браузер считывает инструкции политики разрешений и разрешает или блокирует функции (или API) в соответствии с политикой разрешений. Если сайт хочет ограничить API в определённом регионе, разработчик может установить политику для всех страниц, запрашиваемых из этого региона.
Обновите свой токен
Срок действия пробных токенов Origin истекает через шесть недель с даты их выпуска (или по окончании пробного периода, если это наступит раньше).
Крайне важно обновить и развернуть новые токены в течение этого периода для бесперебойного использования пробных функций Origin.
Продление токенов занимает всего несколько минут, и вы можете развернуть несколько токенов для одного и того же пробного периода на одной странице. Вы можете развернуть обновлённый токен до истечения срока действия текущего токена, чтобы пользователи могли пользоваться сервисом без перерывов.
Тестирование локально
Конкретные рекомендации по тестированию локальных разработчиков см. ниже:
API-интерфейсы отключены по умолчанию и должны быть включены с помощью флагов для тестирования. Убедитесь, что у вас включены те же параметры конфигурации, что и выше, а затем:
- Используйте версию и канал Chrome , где эти функции доступны.
- Включите все API конфиденциальности рекламы в разделе
chrome://settings/adPrivacy.
Проверьте руководства разработчика на наличие определенных API и функций, а также дополнительных флагов для более точной настройки.