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”（主题状态）面板会显示主题 ID、随机主题分配和真实主题分配，以及分类和模型版本。

此屏幕截图显示，最近访问的网站包括 topics-demo-cats.glitch.me 和 cats-cats-cats-cats.glitch.me。这会导致 Topics API 选择 Pets 和 Cats 作为当前周期的两个热门主题。由于浏览记录（在观察主题的网站上）不足以提供五个主题，因此系统随机选择了其余三个主题。

“Observed-by context domains (hashed)”（观察到的上下文网域 [经过哈希处理]）列提供观察到某个主题的主机名的经过哈希处理的值。

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

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

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

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

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

查看 Topics API 信息

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

注意：在 2023 年 6 月之前，Topics 使用的是旧版类目。为了展示更具相关性的广告，建议您使用最新版类目。

在本例中，time_period_per_epoch 已设为 15 秒（默认值为 7 天）。

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

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

Next steps

Control & transparency

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.

Support

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.

• Check out Topics demos, collab and walkthrough videos.
• See the list of Chrome flags that allow developers to customize the Topics API for testing.
• See how users and developers can control the API.
• Check out the resources for technical explainers and support. Ask questions, engage and share feedback.