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

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

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

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

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

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

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

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

后续步骤

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

另请参阅

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