Sec-Browsing-Topics header

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

警告:此功能目前受到两家浏览器厂商的反对。有关反对的详细信息,请参阅标准立场部分。

注意:要在您的应用程序中使用此功能,需要进行注册过程

HTTP 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,浏览器可以使用它从分类中检索主题(参见兴趣分类示例)。

版本

configVersionmodelVersiontaxonomyVersion,它们之间用冒号 (:) 连接。

示例

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

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

规范

此功能不是官方标准的一部分,尽管它在Topics API 非官方提案草案中有所说明。

浏览器兼容性

另见