Темы API: инструменты тестирования и анализа

Узнайте об инструментах, доступных в Chrome, для просмотра информации Topics API, понимания того, как назначаются темы, и отладки вашей реализации.

Просмотр информации об API тем

Страница chrome://topics-internals доступна в Chrome на компьютере после включения API тем . Здесь отображаются темы для текущего пользователя, темы, предполагаемые для имен хостов, а также техническая информация о реализации API. Мы повторяем и улучшаем дизайн страницы на основе отзывов разработчиков. Вы можете формировать API Topics, отправив свой отзыв как ошибку Chromium .

Просмотр тем, наблюдаемых в вашем браузере

Пользователи могут просматривать информацию о темах, наблюдаемых в их браузере в текущую и предыдущую эпохи, открыв chrome://topics-internals .

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

На этом снимке экрана видно, что недавно посещенные сайты включают в себя topics-demo-cats.glitch.me и cats-cats-cats-cats.glitch.me . Это приводит к тому, что API тем выбирает Pets и Cats в качестве двух главных тем текущей эпохи. Остальные три темы были выбраны случайным образом , поскольку истории посещений (на сайтах, которые наблюдают за темами) недостаточно для предоставления пяти тем.

Столбец «Обсервируемые контекстные домены (хешированные)» предоставляет хешированное значение имени хоста, для которого наблюдалась тема.

Просмотр тем, предполагаемых для имен хостов

Вы также можете просмотреть темы, определенные моделью классификатора тем для одного или нескольких имен хостов в chrome://topics-internals .

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

Текущая реализация Topics API определяет темы только по именам хостов; а не из какой-либо другой части URL-адреса.

Используйте только имена хостов (без протокола или пути) для просмотра тем, выведенных из классификатора chrome://topics-internals . chrome://topics-internals отобразит ошибку, если вы попытаетесь добавить «/» в поле «Хост».

Просмотр информации об API тем

Информацию о реализации и настройках Topics API, например о версии таксономии и продолжительности эпохи, можно найти в chrome://topics-internals . Эти значения отражают настройки API по умолчанию или параметры, успешно установленные из командной строки . Это может быть полезно для подтверждения того, что флаги командной строки работают должным образом.

В примере time_period_per_epoch установлено на 15 секунд (по умолчанию — семь дней).

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

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

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

Колаб

Запустите Colab , чтобы узнать, как загрузить модель TensorFlow Lite, используемую Chrome для определения тем по именам хостов. Инструкции вы найдете в описании colab или в видеоролике с пошаговым руководством . Обратите внимание, что в этой совместной работе используется старая версия таксономии .

Используйте API тем на веб-сайтах с prebid.js.

Как отмечается в релизе Prebid 7 , сообщество активно развивало интеграцию с Topics API с помощью нового модуля. Этот модуль был объединен в декабре 2022 года. Прочтите документацию по модулю Prebid's Topics API . Для получения дополнительной информации об интеграции обратитесь к Prebid.js через любой стандартный канал, который они предлагают.

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

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

См. также

Ознакомьтесь с нашими ресурсами, чтобы лучше понять API Topics в Интернете.