Sec-Browsing-Topics

实验性： 这是一个实验性技术
在生产环境中使用此功能之前，请仔细查看浏览器兼容性表。

非标准： 此功能是非标准的，并且不在标准轨道上。不要在面向网络的生产站点上使用它：它不会为每个用户工作。实现之间也可能存在很大的不兼容性，并且行为在将来可能会发生变化。

警告： 此功能目前遭到两个浏览器供应商的反对。有关反对意见的详细信息，请参见标准立场部分。

注意： 在您的应用程序中使用此功能需要注册过程。

Sec-Browsing-Topics 请求头将当前用户的选定主题与其关联的请求一起发送，这些主题由广告技术平台用于选择要显示的个性化广告。

如果调用站点没有在成功的隐私沙箱注册过程中包含 Topics API，则尝试创建或修改 Sec-Browsing-Topics 会静默失败，并且任何现有的 Sec-Browsing-Topics 标头将被删除。

有关更多详细信息，请参见使用 Topics API。

标头类型 请求标头
禁止的标头名称 是（前缀 Sec-）

语法

http
Sec-Browsing-Topics: <array-of-observed-topics>

指令

一个 JSON 对象，表示一个数组，最多包含三个表示当前用户在过去三个时期中选择的主题的对象。每个对象包含以下属性

configVersion

一个字符串，标识用于计算主题的算法（模型部分除外）。

modelVersion

一个字符串，表示用于将字符串（例如网页的域名）分类为主题 ID 的模型。

taxonomyVersion

一个字符串，表示使用的分类版本。

topic

一个表示主题 ID 的数字，浏览器可以使用它从分类中检索主题（参见示例兴趣分类）。

version

configVersion、modelVersion 和 taxonomyVersion，它们之间用冒号（:）连接。

示例

确切的属性值可能因浏览器实现而异。来自 Chrome 的示例标头可能如下所示

http
Sec-Browsing-Topics: [{configVersion: "chrome.1", modelVersion: "1", taxonomyVersion: "1", topic: 43, version: "chrome.1:1:1"}]

规范

此功能不是官方标准的一部分，尽管它在Topics API 非正式提案草案中有所规定。

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅