Демонстрации API тем

Поэкспериментируйте и узнайте, как темы выводятся из имен хостов с минимальной настройкой.

Статус реализации

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

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

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

Вы также можете запустить совместную работу Topics, чтобы опробовать модель классификатора Topics.

В следующем видео показано, как работает демо.

Тестируйте с помощью chrome://flags или флагов функций.

Есть два способа попробовать API Topics в качестве одного пользователя; вам понадобится Chrome 101 или более поздняя версия:

  • Включите API на странице chrome://flags/#privacy-sandbox-ads-apis Chrome:

    Включите API тем на странице chrome://flags/#privacy-sandbox-ads-apis.
    Страница chrome://flags/#privacy-sandbox-ads-apis на которой вы можете включить или отключить API.

  • Запустите Chrome из командной строки со следующими флагами:

    --enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/browsing_topics_max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Демонстрация API тем

Демо-версия Topics показывает, как использовать дополнительные флаги для настройки параметров, таких как продолжительность эпохи. Если вы получаете доступ к API тем, запустив Chrome с флагами командной строки, не устанавливайте chrome://flags , поскольку они могут переопределить настройки командной строки.

Запуск Chromium с флагами объясняет, как устанавливать флаги при запуске Chrome и других браузеров на основе Chromium из командной строки, хотя эта демонстрация предназначена только для Google Chrome.

Демонстрация заголовков API Topics

Демо-версия на темы-fetch-demo.glitch.me показывает, как использовать заголовки запросов и ответов fetch() для доступа к темам и пометки их как наблюдаемых.

Доступ к заголовку запроса Sec-Browsing-Topics

Вместо использования document.browsingTopics() из iframe для просмотра тем для пользователя, вызывающие API могут получить доступ к наблюдаемым темам из заголовка запроса Sec-Browsing-Topics запроса fetch() , который включает {browsingTopics: true} в параметре options. — или из того же заголовка запроса XHR , который устанавливает для атрибута deprecatedBrowsingTopics значение true .

Например:

fetch('https://topics-server.glitch.me', {browsingTopics: true})
    .then((response) => {
        // Process the response
 })

В браузерах, поддерживающих API, запрос fetch() будет включать заголовок Sec-Browsing-Topics , в котором перечислены темы, наблюдаемые для имени хоста URL-адреса запроса: в этом примере — topics-server.glitch.me .

Если для этого имени хоста и этого пользователя темы не наблюдались, заголовок включается, но значение пустое. Другими словами, заголовок Sec-Browsing-Topics в запросе fetch() включает только темы, которые наблюдались в браузере текущего пользователя вызывающей стороной, чье происхождение соответствует имени хоста URL-адреса запроса. Это то же самое, как если бы вы вызывали document.browsingTopics() из iframe для просмотра наблюдаемых тем для текущего пользователя.

Заголовок запроса отправляется при условии, что для него действует соответствующая политика разрешений, контекст защищен и настройки пользователя это позволяют. Темы не предоставляются в заголовках для навигационных запросов.

Заголовок запроса Темы выглядит следующим образом:

Sec-Browsing-Topics: 186;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1", 265;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1"

Этот пример включает две темы из таксономии Тем , 186 и 265, а также информацию о версии каждой темы.

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

Отмечайте темы как наблюдаемые с помощью Observe-Browsing-Topics

Если запрос включает заголовок Sec-Browsing-Topics , а ответ на этот запрос включает заголовок Observe-Browsing-Topics: ?1 , то темы из заголовка запроса будут помечены браузером как наблюдаемые. Наблюдаемые темы могут рассчитываться API тем. Этот механизм разработан так, чтобы соответствовать функциональности, предоставляемой API JavaScript из iframe.

На скриншоте ниже показаны темы, записанные при посещении сайтов на демо-странице API.

Демо-страница API Topics на сайте glitch.me
Демо-версия glitch.me для тестирования API.

В этом списке показаны сайты, которые вы можете посетить из демо-версии, чтобы записать интересующие вас темы. Как вы можете видеть, категория «Искусство и развлечения/Юмор» на скриншоте не является темой ни одного из этих веб-сайтов, поэтому эта записанная тема была добавлена ​​в качестве возможных 5-процентных случайных тем.

  • домашние животные-животные-домашние животные-cats.glitch.me
  • кошки-кошки-кошки-cats.glitch.me
  • кошки-питомцы-животные-pets.glitch.me
  • кошки-кошки-мяу-мурлыкать-усы-питомец.глюк.

Вы можете проверить, какие темы настоящие, а какие случайные, на вкладке «Состояние тем» на странице chrome://topics-internals . На этом снимке экрана показан пример из разных сеансов просмотра.

На вкладке «Состояние тем» представлена ​​информация о наблюдаемых темах.
Вкладка «Состояние тем», показывающая реальные и случайные темы.

Следующие шаги

Если вы разработчик рекламных технологий, экспериментируйте и участвуйте в работе с Topics API. Прочтите руководство для разработчиков , чтобы получить более подробные ресурсы.

Привлекайте и делитесь отзывами