Topics API:测试和分析工具

了解 Chrome 中提供的工具,以便您查看 Topics API 信息、了解如何分配主题以及调试实现情况。

查看 Topics API 信息

启用 Topics API 后,桌面版 Chrome 中会显示 chrome://topics-internals 页面。此页面会显示当前用户的主题、为主机名推断出的主题,以及有关 API 实现的技术信息。我们会根据开发者的反馈迭代和改进该页面的设计。您可以将反馈作为 Chromium bug 提交,以帮助完善 Topics API。

查看系统为您的浏览器观察到的主题

用户可以通过查看 chrome://topics-internals,查看有关其浏览器在当前周期和之前的周期中观察到的主题的信息。

chrome://topics-internals 页面,其中已选择“Topics State”面板。
chrome://topics-internals页面的“Topics State”面板会显示主题 ID、随机和实际主题分配、分类和模型版本。

此屏幕截图显示最近访问过的网站包括 topics-demo-cats.glitch.mecats-cats-cats-cats.glitch.me。这会使 Topics API 选择 PetsCats 作为当前周期的两个热门主题。其余 3 个主题是随机选择的,因为(在观察主题的网站上)没有足够的浏览记录来提供 5 个主题。

观测到的上下文网域(经过哈希处理)列提供观测到主题的主机名的哈希值。

查看为主机名推断出的主题

您还可以查看 chrome://topics-internals 中的主题分类器模型为一个或多个主机名推断的主题。

已选中“Classifier”面板的 chrome://topics-internals 页面。
chrome://topics-internals 页面的“Classifier”面板显示已选择的主题、访问过的主机以及模型版本和路径。

Topics API 的当前实现仅根据主机名推断主题;而不是来自网址的任何其他部分

仅使用主机名(不含协议或路径)即可查看 chrome://topics-internals 分类器推断出的主题。如果您尝试在“Host”字段中添加“/”,chrome://topics-internals 会显示错误。

查看 Topics API 信息

您可以在 chrome://topics-internals 中找到有关 Topics API 实现和设置的信息,例如分类法版本和纪元时长。这些值反映了 API 的默认设置或从命令行成功设置的参数。这可能有助于确认命令行标志是否按预期运行。

在此示例中,time_period_per_epoch 设为 15 秒(默认为 7 天)。

chrome://topics-internals 页面,其中“功能和参数”面板处于选中状态。
chrome://topics-internals“功能和参数”面板会显示已启用的功能、每个周期的时间、用于计算主题的周期数、分类法版本和其他设置。

屏幕截图中显示的参数对应于从命令行运行 Chrome 时可以设置的标志。如需详细了解如何使用 Chrome 标志来控制 Topics API,请参阅专门的设置部分。

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

Colab

运行 Colab,了解如何加载 Chrome 用于根据主机名推断主题的 TensorFlow Lite 模型。您可以在 Colab 说明或演示视频中找到相关说明。请注意,此 Colab 使用的是旧版分类功能

在采用 prebid.js 的网站上使用 Topics API

正如在 Prebid 7 的发布版本中所述,社区使用新模块积极开发了与 Topics API 的集成。此模块已于 2022 年 12 月合并。阅读预出价的 Topics API 模块文档。如需详细了解此集成,请通过 Prebid.js 提供的任何标准渠道与其联系。

Next steps

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.
Check out our resources for troubleshooting, technical support, filing bugs and asking questions.

See also

Check out our resources to better understand the Topics API on the Web.