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 提供的任何标准渠道与他们联系。

后续步骤

了解用户和开发者如何管理和自定义 Topics API,以满足用户的偏好和需求。
请查看我们的资源,了解如何进行问题排查、获取技术支持、提交 bug 和提问。

另请参阅

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