共用儲存空間總覽

透過保護隱私權的讀取權限，允許無限制的跨網站儲存空間寫入存取權。

導入狀態

本文件概述未分區跨網站儲存的提案：Shared Storage API。

建議採行的做法 狀態
內容選取作業適用的事件層級報表 (selectURL()) 至少 2026 年開放使用
個別網站預算管理
說明		 於 M119 推出
允許從回應標頭寫入
說明
GitHub 問題		 M124 版本。可在 M119 至 M123 中手動啟用
私人匯總捐款逾時
說明		 於 M119 推出
使用開發人員工具對共用儲存空間工作程式碼偵錯
章節		 於 M120 提供
將共用儲存空間資料儲存空間上限更新為 5MB
說明		 適用於 M124

為什麼需要這個 API？

為避免跨網站追蹤使用者，瀏覽器正在分割所有形式的儲存空間 (Cookie、localStorage、快取等)。但是，在一些合法使用案例上，依賴未分區的儲存空間，如果沒有新的網路 API 幫助，就無法執行。例如，內容製作者可能想要評估不同網站的觸及率，而不依賴跨網站 ID。

Shared Storage API 可讓網站儲存及存取未分區的跨網站資料。這類資料必須在安全的環境中讀取，以免外洩。

您可以透過下列兩種方式使用共用儲存空間資料：

適用對象

有各種不同類型的公司可能會因為使用 Shared Storage API 而受益。例如：

  • 廣告技術可以評估廣告活動觸及成效、設定展示頻率上限，以及輪播廣告素材，所有功能目前都仰賴第三方 Cookie。
  • 付款服務供應商可以判斷使用者是否已經是現有客戶，並提供個人化的結帳程序。
  • 網路安全公司可以建立自訂邏輯來標記可疑或危險的行為。

貴公司是否正在尋找尚未解決的跨網站儲存解決方案？分享用途。

用途

Shared Storage API 將支援許多現有用途，取代許多現有的第三方 Cookie 使用方式。違規的行為與內容包括：

應用實例 說明 輸出閘門
輪播廣告素材 您可以儲存廣告素材 ID、觀看次數和使用者互動等資料，以便決定要在不同網站上看到哪些廣告素材。如此一來，你就能在觀看次數之間取得平衡，並避免特定內容過度飽和，避免對使用者體驗造成負面影響。 選擇網址
執行 A/B 測試 您可以將使用者指派給實驗群組，然後將該群組儲存在共用儲存空間中，以便跨網站存取。 選擇網址
為已知客戶自訂使用者體驗 可根據使用者的註冊狀態或其他使用者狀態分享自訂內容和行動號召。 選擇網址
反濫用緩解 反濫用、反詐騙和網路安全性組織通常會使用獨家技術來偵測惡意使用者，無論是自動機器人或真正試圖造成傷害的真人。在這裡可以測試各種不同的策略，無論是使用網址選取輸出閘對使用者信任度評分進行編碼，還是使用私人匯總輸出界限來建立異常偵測資料集，都可以。 網址選擇，Private Aggregation API
評估不重複觸及率 許多內容製作者和廣告客戶通常會想知道有多少不重複的觀眾看過他們的內容。您可以使用「共用儲存空間」記錄使用者第一次看到廣告、內嵌影片和出版物，還能避免重複計算同一位使用者在不同網站上的情況，然後取得匯總的不重複觸及率匯總報表。 私密匯總 API
評估使用者客層 內容製作者往往會希望瞭解自己的觀眾客層。您可以使用共用儲存空間，在您擁有的環境 (例如第一方網站) 上記錄使用者的客層資料，並利用匯總報表製作其他網站 (例如嵌入的內容) 中的相關資料。 私密匯總 API
評估 K+ 頻率觸及 有時也稱為「有效展示頻率」，是指使用者認得或記得特定內容 (通常是廣告觀看次數) 之前，至少需要幾次幾次才認識或再次印象。你可以使用「共用儲存空間」為看過某項內容至少 K 次的不重複使用者建立報表。 私密匯總 API

本提案旨在建構一個通用用途 API，支援許多未來可能的用途。這樣一來，您就能進一步實驗和改變 與網路生態系統一起成長

共用儲存空間如何運作？

Shared Storage 可讓您根據跨網站資料做出明智的決策，而不必與嵌入網站分享使用者資訊 (例如瀏覽器記錄或其他個人詳細資料)，也不會將資料洩漏到您的伺服器。

您可以隨時寫入共用儲存空間，就像其他 JavaScript 儲存 API (例如 localStorage 或已建立索引的資料庫) 一樣。有別於其他 Storage API，您只能在安全環境中 (稱為共用儲存空間小程式) 讀取共用儲存空間值。

Worklet 可讓您新增商業邏輯。在 Worklet 中，您可以讀取及處理共用儲存空間中的值，但無法直接將確切值傳回給 Worklet 呼叫端。為擷取實用的資訊，您可以使用一組「閘門」。目前有兩個閘門，日後可能會新增更多。

可用的 Shared Storage API 輸出閘有：

  • 選擇跨網站網址：您可以執行 Worklet 指令碼，根據儲存的資料從提供的清單中選擇網址，然後將內容顯示在圍欄頁框中。
  • 使用 Private Aggregation API 進行雜訊匯總：您可以執行工作程式，透過 Private Aggregation API 傳送跨網站資料，並傳回摘要報表。

試用 Shared Storage API

網址選擇輸出閘和私人匯總輸出門檻的 Shared Storage API 可供測試。您可以在 Chrome 中測試內容選擇功能 Canary/Dev/Beta M105 以上版本和 Private Aggregation API 可在 Chrome M107 以上版本初期測試版本和開發人員版中進行測試。啟用 chrome://settings/adPrivacy 底下的所有廣告隱私權 API 即可測試這個 API。

使用示範

我們提供示範模式，如需查看程式碼，請前往 GitHub。

本示範的建構依據是廣告客戶、廣告技術、內容發布商或其他第三方服務，而這些服務想要在不同發布商的網站上儲存資訊。在示範中，同一個第三方程式碼會針對每個用途，在「發布商 A」和「發布商 B」網站上執行。請前往發布者的網頁，瞭解資料在跨網站環境中的分享方式。

這個示範包含內容選取與私人匯總的用途。

如需內容選擇示範，請參閱「輪播廣告素材」、「針對已知客戶自訂使用體驗」和「執行 A/B 測試」等用途。

如果是「私人匯總」示範，您可以預覽不重複「評估不重複觸及」和「評估 K+ 頻率觸及」。評估使用者客層，以及

使用開發人員工具對共用儲存空間的工作程式進行偵錯

如要檢查從目前頁面中啟動的「共用儲存空間」工作程式，您可以前往開發人員工具面板中的「來源」分頁，然後新增「共用儲存空間小程式 / 指令碼第一個陳述式」事件監聽器中斷點。這個中斷點會在啟動時暫停執行初始模組指令碼或短期工作程式。

新增事件層級事件監聽器，對共用儲存空間工作程式進行偵錯。
您可以將中斷點新增至「共用儲存空間」工作程式。

此外，chrome://inspect/#shared-storage-worklets 頁面會顯示所有頁面中所有使用中的「共用儲存空間」工作程式。

交流及分享意見回饋

共用儲存空間提案仍在進行中的討論，日後可能會有變動。如果您試用這個 API，並有任何意見，歡迎與我們分享。