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

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

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

Страница chrome://topics-internals доступна в Chrome на рабочем столе после включения API тем . Она отображает темы для текущего пользователя, темы, выведенные для имен хостов, и техническую информацию о реализации API. Мы дорабатываем и улучшаем дизайн страницы на основе отзывов разработчиков. Вы можете сформировать API тем, отправив свой отзыв как ошибку 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 показывает выбранные темы, посещенные хосты, а также версию модели и путь.

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

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

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

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

, , ,

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

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

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

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

Колаб

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

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

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

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

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

См. также

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