Topics API:测试和分析工具

了解 Chrome 中可用于查看 Topics API 信息的工具,并了解主题的分配方式。

查看 Topics API 信息

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

查看浏览器中观察到的主题

用户可以通过查看 chrome://topics-internals 来查看浏览器在当前周期和上一个周期内观察到的主题的相关信息。

chrome://topics-internals 页面,其中“主题状态”面板处于选中状态。
“主题状态”面板 (chrome://topics-internals 页面) 会显示主题 ID、随机和实际主题分配,以及分类和模型版本。

此屏幕截图显示,最近访问过的网站包括 topics-demo-cats.glitch.mecats-cats-cats-cats.glitch.me。这会导致 Topics API 选择 PetsCats 作为当前周期的两个热门主题。由于浏览记录(在遵守主题的网站上)不足以提供 5 个主题,因此剩余 3 个主题是随机选择的

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

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

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

chrome://topics-internals 页面,其中“分类器”面板处于选中状态。
“网页分类器”面板 chrome://topics-internals 显示所选主题、访问过的主机以及模型版本和路径。

Topics API 的当前实现仅从主机名推断主题,而不从网址的任何其他部分推断主题。

仅使用主机名(不含协议或路径)即可查看 chrome://topics-internals 分类器的推断主题。如果您尝试在“主机”字段中添加“/”,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 flag 控制 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 月合并。阅读 Prebid 的 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.

另请参阅

请查看我们的资源,以便更好地了解 Web 版 Topics API。