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

configVersionmodelVersiontaxonomyVersion,它們之間用冒號(:)連線。

示例

確切的屬性值可能因瀏覽器實現而異。來自 Chrome 的示例標頭可能如下所示

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

規範

此功能不是官方標準的一部分,儘管它在Topics API 非正式提案草案中有所規定。

瀏覽器相容性

BCD 表僅在瀏覽器中載入

另請參閱