Темы, изолированные фреймы и общее хранилище. Ключевые слова: продукт: PrivacySandbox, docType: Guide, themeAdSetup, contentTypeSolution, категория: Интернет, apiGroupAds, AudienceAdBuyer, AudienceAdSeller, AudienceAdMeasurementProvider, навык: Новичок
Privacy Sandbox включает в себя набор предложений, позволяющих использовать рекламные варианты без необходимости межсайтового отслеживания. Пробные версии Origin дают разработчикам возможность оценить и оставить отзыв о новых веб-технологиях посредством тестирования в реальных условиях. Пробная версия Privacy Sandbox Relevance and Measurement origin представляет собой единую пробную версию, позволяющую сайтам проводить унифицированные эксперименты с отчетами об атрибуции, API защищенной аудитории, темами, изолированными фреймами и общим хранилищем. Разработчики могут подписаться на эту пробную версию для одного источника, которая позволяет тестировать все темы, API защищенной аудитории и API отчетов по атрибуции. Это руководство проведет вас через этапы настройки для доступа к API, расскажет, как проверить вашу конфигурацию, и предоставит дополнительные ресурсы для тестирования API.
Проверьте статус исходной пробной версии
июнь 2023 г.
Рост частной агрегации на 7 % в стабильной версии
API частного агрегирования будет доступен в размере 7 % трафика Chrome Stable со вторника, 6 июня 2023 г. API будет доступен в основной пробной группе единого источника (5 %), изолированной группе защищенной аудитории (1 %) и общем хранилище. изолированная группа (1%). Распределение трафика для защищенной аудитории и общего хранилища не изменится, поскольку к существующим изолированным экспериментам добавляется частное агрегирование.
Распределение трафика по состоянию на вторник, 6 июня:
| API | Распределение трафика | Статус |
| Отчеты по атрибуции | Единый - 5% | 6% стабильного трафика по состоянию на 13 марта 2023 г. |
| Изолированный – 1% – только ARA | ||
| Огороженные рамы | Единый - 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() частного агрегирования доступна для использования в рабочих модулях Protected Audience API и Shared Storage .
Начиная с понедельника, 17 апреля, распределение трафика будет выглядеть следующим образом:
| API | Распределение трафика | Статус |
| Отчеты по атрибуции | Единый - 5% | 6% от Стабильного трафика с 13 марта 2023 г. |
| Изолированный – 1% – только ARA | ||
| Огороженные рамы | Единый - 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 г., поскольку для их подготовки требуется дополнительное время. Повышение 1% API Protected Audience с 4% до 5% также произойдет в четверг, 16 марта 2023 г.
API Protected Audience: резервное копирование на 1 %
В прошлом месяце мы временно сократили трафик исходной пробной версии API Protected Audience API с 5% до 4% от стабильного трафика Chrome для тестирования. Первоначальное тестирование завершилось, и мы планируем увеличить API-интерфейс Protected Audience до 5 % с 4 % для единого эксперимента в четверг, 16 марта 2023 г.
Увеличивающиеся пользователи будут теми же пользователями, которые были сокращены. Однако срок действия их предыдущих групп интересов истек, поскольку с момента спада прошло более 30 дней.
Отдельные эксперименты
Чтобы улучшить процесс тестирования и продолжить наблюдение за метриками исходных пробных API, мы создаем отдельные эксперименты для каждого API в дополнение к существующему единому эксперименту. Новые эксперименты будут созданы для отчетов об атрибуции, тем, комбинации API защищенной аудитории и изолированных фреймов, а также комбинации операции выбора URL-адреса общего хранилища и изолированных фреймов. В каждом изолированном эксперименте пользователям в этой группе будут доступны только назначенные API.
| API | Изолированный эксперимент распределение трафика |
|---|---|
| Отчеты по атрибуции | 1% |
| API защищенной аудитории + изолированные фреймы | 1% |
| Общее хранилище (выбор URL-адреса) + изолированные фреймы | 1% |
| Темы | 1% |
Начиная с четверга, 16 марта, вы начнете получать дополнительно 1 % трафика Chrome Stable для перечисленных выше API в дополнение к 5 % трафика, который вы получаете в рамках существующего единого эксперимента. Для каждого эксперимента будут выделяться новые пользователи.
Распределение трафика
Текущее распределение пробного трафика единого источника по состоянию на вторник, 28 февраля, выглядит следующим образом:
| API | Текущий объединенный эксперимент распределение трафика |
|---|---|
| Отчеты по атрибуции | 5% |
| Огороженные рамы | 5% |
| API защищенной аудитории | 4% |
| Общее хранилище (выбор URL-адреса) | 5% |
| Темы | 5% |
Распределение трафика будет выглядеть следующим образом, начиная с четверга, 16 марта, после возобновления работы API Protected Audience и начала новых изолированных экспериментов:
| API | Новое распределение трафика | Статус |
|---|---|---|
| Отчеты по атрибуции | Единый - 5% | 6% от Стабильного трафика с 16 марта 2023 г. |
| Изолированный – 1% – только ARA | ||
| Огороженные рамы | Единый - 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 мы временно сократим исходный трафик пробной версии API Protected Audience API с 5% до 4% от Chrome Stable с 26 января 2023 года. По нашим оценкам, расследование займет около месяца, и мы уведомим вас, когда трафик снова увеличивается.
Это изменение произойдет автоматически и не повлияет на ваши существующие пробные токены Origin. Для пользователей из 1% трафика, который будет снижаться, группы по интересам останутся в своих браузерах. Те же пользователи будут участвовать в резервном копировании, а их группы по интересам можно будет использовать повторно. Однако срок действия групп по интересам истекает через 30 дней, и регрессионное расследование может занять больше времени.
Кроме того, с 26 января 2023 года пробная версия API выбора URL-адреса Shared Storage увеличит долю трафика Chrome Stable до 5%.
| API | Примечания |
|---|---|
| Отчеты по атрибуции | Доступно в стабильной версии, увеличено до 5% с 26 октября 2022 г. |
| Темы | Доступно в стабильной версии, увеличено до 5% с 26 октября 2022 г. |
| API защищенной аудитории | Доступно в стабильной версии, с 26 января 2023 года временно снижается до 4%. |
| Огороженные рамы | Доступно в стабильном режиме, с 9 ноября 2022 года скидка увеличится до 5%. |
| Общее хранилище | Доступно в стабильной версии, с 26 января 2023 года повышение на 5%. |
ноябрь 2022 г.
API selectURL от Shared Storage присоединится к пробной версии Origin с 9 ноября на уровне 1% трафика Chrome Stable.
Как было объявлено ранее в сообщении в блоге «Повышение релевантности и измерения исходной среды конфиденциальности до 5%» , отчеты и темы по атрибуции теперь составляют 5%, а 9 ноября также появятся API защищенной аудитории и огражденные фреймы.
| API | Примечания |
|---|---|
| Отчеты по атрибуции | Доступен в стабильной версии, увеличен до 5% с 26 октября. |
| Темы | Доступен в стабильной версии, увеличен до 5% с 26 октября. |
| API защищенной аудитории | Доступно в стабильной версии, с 9 ноября скидка увеличивается до 5%. |
| Огороженные рамы | Доступно в стабильной версии, с 9 ноября скидка увеличивается до 5%. |
| Общее хранилище | Будет доступно в стабильной версии, начиная с 1% с 9 ноября. |
Октябрь 2022 г.: увеличение на 5 %.
Отчеты об атрибуции, темы, API защищенной аудитории и изолированные фреймы в настоящее время доступны в стабильной версии Chrome и будут частью увеличенного трафика.
С этой недели мы начнем увеличивать трафик для отчетов и тем по атрибуции, API Protected Audience API и Fenced Frames увеличится с 9 ноября.
Подробную информацию можно найти в публикации в блоге «Повышение релевантности и измерения исходной среды конфиденциальности до 5 %» .
| API | Примечания |
|---|---|
| Отчеты по атрибуции | Доступно в стабильном режиме, после 26 октября скидка увеличивается до 5%. |
| Темы | Доступно в стабильном режиме, после 26 октября скидка увеличивается до 5%. |
| API защищенной аудитории | Доступно в стабильной версии, с 9 ноября скидка увеличивается до 5%. |
| Огороженные рамы | Доступно в стабильной версии, с 9 ноября скидка увеличивается до 5%. |
| Общее хранилище | На данный момент доступно только в M105+ Canary, Dev и Beta. |
Октябрь 2022 г.
- Пробная версия Origin продлена до Chrome 110 .
- В разделе «Приступая к работе с пробными версиями Chrome Origin» объясняется, как продлить подписку на пробную версию Origin. Это включает в себя предоставление нового токена участвующим источникам, что представляет собой тот же процесс, за которым следует любое другое продление пробной версии источника.
Это расширение было предоставлено, чтобы дать экосистеме время в стабильном канале для продолжения тестирования и проверки улучшений API, обеспечивая при этом обратную связь в соответствии с нашим существующим общедоступным графиком.
Общий график Privacy Sandbox остается неизменным.
API, включенные в пробную версию:
| API | Примечания |
|---|---|
| Отчеты по атрибуции | Руководство для разработчиков по пробной версии Origin . |
| API защищенной аудитории | Руководство для разработчиков по пробной версии Origin . |
| Темы | Руководство для разработчиков по пробной версии Origin . |
| Огороженные рамы | См. руководство по API Protected Audience для использования пробной версии Origin. |
| Общее хранилище | На данный момент доступно только в M105+ Canary, Dev и Beta. |
август 2022 г.
- Доступность пробной версии Origin увеличивается до 1% пользователей настольных компьютеров после Chrome Stable 104 .
- Обновления будут появляться, когда доступность будет включать мобильных пользователей.
- Предварительно стабильные каналы (Canary, Beta) остаются у 50% пользователей.
- API недоступны в iOS Chrome.
май 2022 г.
Доступность пробной версии Origin увеличивается до 50% пользователей бета-версии Chrome 102 .
API, включенные в пробную версию:
| API | Примечания |
|---|---|
| Отчеты по атрибуции | Руководство для разработчиков по пробной версии Origin . |
| API защищенной аудитории | Руководство для разработчиков по пробной версии Origin . |
| Темы | Руководство для разработчиков по пробной версии Origin . Темы были ненадолго отключены в пробной версии Origin из-за ошибки, влиявшей на стабильность браузера. |
| Огороженные рамы | В исходную пробную версию добавлены Fenced Frames. См. руководство по API Protected Audience для использования в экспериментах. |
апрель 2022 г.
Пробная версия Origin начинается с ограниченной части пользователей Chrome 102 Beta .
API, включенные в пробную версию:
| API | Примечания |
|---|---|
| Отчеты по атрибуции | Сообщение об индивидуальном намерении экспериментировать (I2E) . Отчеты об атрибуции также доступны в виде пробной версии для отдельных источников. |
| API защищенной аудитории | Сообщение об индивидуальном намерении экспериментировать (I2E) . API Protected Audience доступен для настольных компьютеров только с ограниченным набором функций . |
| Темы | Сообщение об индивидуальном намерении экспериментировать (I2E) . |
Зарегистрируйтесь и настройте пробную версию 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.
- Поле «Происхождение веб-сайта» должно указывать источник вашего скрипта.
- Вставьте тег
<meta>в страницу верхнего уровня (то есть в первую страницу, а не в свой собственный контент) из вашего скрипта. Например:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
Отладка пробной версии источника
Вы можете проверить статус исходной пробной версии в DevTools > панель «Приложения» .
- Прокрутите вниз до панели «Кадры» .
- Выберите кадр, в котором вы планируете установить токен. Например, верхний фрейм для страницы верхнего уровня или конкретный iframe для встроенных страниц.
- На правой панели прокрутите вниз до раздела «Пробные версии Origin» .
- Вы должны увидеть запись о пробной версии
PrivacySandboxAdsAPIs. - Разверните эту запись, чтобы увидеть статус пробной версии Origin и ваших конкретных токенов.
Пробная версия Origin доступна лишь небольшой части пользователей Chrome, и ваш браузер может не входить в экспериментальную группу. В результате вы можете увидеть красное сообщение TrialNotAllowed для PrivacySandboxAdsAPIs . Если при раскрытии записи для проверки статуса токена отображается зеленое сообщение Success , конфигурация пробной версии источника верна. Соответствующие требованиям пользователи увидят сообщение со значением Enabled .
Если вы видите разные сообщения, обратитесь к разделу «Устранение неполадок исходных пробных версий Chrome» , чтобы получить подробный контрольный список для проверки конфигурации исходной пробной версии.
Обнаружение функций
Как и в случае со всеми веб-функциями, вам следует проверить, что они доступны в браузере, прежде чем пытаться их использовать. Вы можете сделать это, проверив наличие соответствующего 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. - находиться в стандартном сеансе просмотра, а не в режиме инкогнито .
Хотя исходная пробная версия будет отображаться как активная только для соответствующих пользователей, вы также можете использовать флаги разработчика для тестирования на своем собственном рабочем сайте.
Контролируйте свое участие в пробной версии Origin
Механика пробной версии источника остается прежней: вы получаете токены пробной версии источника для контекстов, в которых хотите экспериментировать с API. Учитывая увеличение числа тестируемых, вам следует убедиться, что вы активно отслеживаете и контролируете уровень трафика там, где вы решили включить пробную версию.
Хороший подход здесь заключается в следующем:
- Включите пробные токены источника по умолчанию во всех контекстах, где вы хотите поэкспериментировать.
- Используйте обнаружение функций для проверки активных API.
- Если API активны (и, следовательно, браузер подходит для этого эксперимента), выберите, использовать их или нет, исходя из собственных критериев эксперимента. Например, если у вас уже есть инфраструктура A/B-тестирования для экспериментов с процентом трафика, выборкой или каким-либо другим атрибутом, то на этом этапе вы можете решить, какие функции вы будете активно использовать.
Вы можете полностью запретить участие в пробной версии Origin для любого экземпляра браузера, не включая токен в ответ. Например, если вы выполнили собственную квоту на эксперимент или вам необходимо устранить проблему во время пробной версии, отсутствие токена гарантирует, что экспериментальные функции не будут доступны или активны на странице.
Контроль испытаний происхождения по географическому региону
Вы не можете отказаться от пробной версии Origin для определенных регионов. Пробные версии Origin активны на страницах, содержащих токен , включенный через HTTP-заголовки (на стороне сервера) или метатеги HTML (на стороне клиента).
Если вы можете определить местоположение пользователя, вы можете написать код, включающий пробный токен источника на основе этой информации о местоположении. Например, вы можете попытаться использовать IP-адреса для определения местоположения пользователя. IP-адреса могут быть подделаны, поэтому это не гарантированное решение.
Однако географическое происхождение может установить политику разрешений , чтобы контролировать, какие функции можно использовать. Например, us.example.com и uk.example.com являются географическими источниками, которыми можно управлять. Это не означает, что регион отказался от участия в исследовании происхождения.
С помощью политики разрешений сайт добавляет на свои страницы небольшой фрагмент кода, который предоставляет инструкции браузеру. Когда страница загружается, браузер читает инструкции Политики разрешений и разрешает или блокирует функции (или API), как указано в Политике разрешений. Если сайт хочет ограничить API в определенном регионе, разработчик может установить политику для всех страниц, запрашиваемых из этого региона.
Обновите свой токен
Срок действия пробных токенов Origin истекает через шесть недель с даты выпуска (или в конце пробного периода, если это произойдет раньше).
Очень важно, чтобы вы продлили и развернули свои новые токены в течение этого окна для непрерывного использования функций пробной версии источника.
Обновление токенов занимает всего несколько минут, и вы можете развернуть несколько токенов для одной пробной версии на одной странице. Вы можете развернуть обновленный токен до истечения срока действия существующего токена, чтобы не было перерывов в обслуживании для пользователей.
Тестируйте локально
Конкретные рекомендации по тестированию локальных разработчиков см.:
API-интерфейсы не включены по умолчанию, и их необходимо включить с помощью флагов для тестирования. Вы должны убедиться, что у вас включены те же настройки конфигурации, что и выше, а затем:
- Используйте версию и канал Chrome , где доступны эти функции.
- Включите все API конфиденциальности рекламы в
chrome://settings/adPrivacy.
Ознакомьтесь с руководствами для разработчиков, чтобы узнать о доступности определенных API и функций, а также дополнительных флагах для более детальной настройки.