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 非官方提案草案中有所說明。

瀏覽器相容性

另見