Единое исследование происхождения по релевантности и измерению

Темы, изолированные фреймы и общее хранилище. Ключевые слова: продукт: PrivacySandbox, docType: Guide, themeAdSetup, contentTypeSolution, категория: Интернет, apiGroupAds, AudienceAdBuyer, AudienceAdSeller, AudienceAdMeasurementProvider, навык: Новичок

Privacy Sandbox включает в себя набор предложений, позволяющих использовать рекламные варианты без необходимости межсайтового отслеживания. Пробные версии Origin дают разработчикам возможность оценить и оставить отзыв о новых веб-технологиях посредством тестирования в реальных условиях. Пробная версия Privacy Sandbox Relevance and Measurement origin представляет собой единую пробную версию, позволяющую сайтам проводить унифицированные эксперименты с отчетами об атрибуции, API защищенной аудитории, темами, изолированными фреймами и общим хранилищем. Разработчики могут подписаться на эту пробную версию для одного источника, которая позволяет тестировать все темы, API защищенной аудитории и API отчетов по атрибуции. Это руководство проведет вас через этапы настройки для доступа к API, расскажет, как проверить вашу конфигурацию, и предоставит дополнительные ресурсы для тестирования API.

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

Проверьте статус исходной пробной версии

июнь 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» .

Примечание. Зарегистрируйтесь для участия в пробной версии Privacy Sandbox Relevance and Measurement .

Пробные токены 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 > панель «Приложения» .

Статус успешного токена и включен.

1. Прокрутите вниз до панели «Кадры» .
2. Выберите кадр, в котором вы планируете установить токен. Например, верхний фрейм для страницы верхнего уровня или конкретный iframe для встроенных страниц.
3. На правой панели прокрутите вниз до раздела «Пробные версии Origin» .
4. Вы должны увидеть запись о пробной версии PrivacySandboxAdsAPIs .
5. Разверните эту запись, чтобы увидеть статус пробной версии 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. Учитывая увеличение числа тестируемых, вам следует убедиться, что вы активно отслеживаете и контролируете уровень трафика там, где вы решили включить пробную версию.

Примечание. 5 % трафика Chrome Stable не будут напрямую соответствовать 5 % вашего собственного трафика. Фактическая доля трафика, которую получают ваши сайты и сервисы, будет зависеть от состава ваших посетителей.

Хороший подход здесь заключается в следующем:

1. Включите пробные токены источника по умолчанию во всех контекстах, где вы хотите поэкспериментировать.
2. Используйте обнаружение функций для проверки активных API.
3. Если API активны (и, следовательно, браузер подходит для этого эксперимента), выберите, использовать их или нет, исходя из собственных критериев эксперимента. Например, если у вас уже есть инфраструктура A/B-тестирования для экспериментов с процентом трафика, выборкой или каким-либо другим атрибутом, то на этом этапе вы можете решить, какие функции вы будете активно использовать.

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

Контроль испытаний происхождения по географическому региону

Вы не можете отказаться от пробной версии Origin для определенных регионов. Пробные версии Origin активны на страницах, содержащих токен , включенный через HTTP-заголовки (на стороне сервера) или метатеги HTML (на стороне клиента).

Если вы можете определить местоположение пользователя, вы можете написать код, включающий пробный токен источника на основе этой информации о местоположении. Например, вы можете попытаться использовать IP-адреса для определения местоположения пользователя. IP-адреса могут быть подделаны, поэтому это не гарантированное решение.

Однако географическое происхождение может установить политику разрешений , чтобы контролировать, какие функции можно использовать. Например, us.example.com и uk.example.com являются географическими источниками, которыми можно управлять. Это не означает, что регион отказался от участия в исследовании происхождения.

С помощью политики разрешений сайт добавляет на свои страницы небольшой фрагмент кода, который предоставляет инструкции браузеру. Когда страница загружается, браузер читает инструкции Политики разрешений и разрешает или блокирует функции (или API), как указано в Политике разрешений. Если сайт хочет ограничить API в определенном регионе, разработчик может установить политику для всех страниц, запрашиваемых из этого региона.

Предупреждение. Пользователи могут посетить страну происхождения из региона, отличного от того, где они находятся. Другими словами, пользователь из США может иметь возможность посетить uk.example.com . Эти пользователи увидят функции и возможности сайта в США, которые были заблокированы на сайте в Великобритании.

Обновите свой токен

Срок действия пробных токенов Origin истекает через шесть недель с даты выпуска (или в конце пробного периода, если это произойдет раньше).

Очень важно, чтобы вы продлили и развернули свои новые токены в течение этого окна для непрерывного использования функций пробной версии источника.

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

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

Тестируйте локально

Конкретные рекомендации по тестированию локальных разработчиков см.:

• Темы
• API защищенной аудитории
• Отчеты по атрибуции

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

• Используйте версию и канал Chrome , где доступны эти функции.
• Включите все API конфиденциальности рекламы в chrome://settings/adPrivacy .

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