共用儲存空間總覽

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

導入狀態

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

Proposal Status
Event-level reporting for Content Selection (selectURL()) Available until at least 2026
Per-site budgeting
Explainer		 Available in M119
Allow writing from response headers
Explainer
GitHub Issue		 Available in M124. Can be manually enabled in M119-M123
Private Aggregation contribution timeout
Explainer		 Available in M119
Debugging Shared Storage worklets with DevTools
Section		 Available in M120
Update Shared Storage data storage limit to 5MB
Explainer		 Available in 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

本提案旨在建立支援 可能的用途以便進一步實驗和改變 ，在網路生態系統中持續成長。

共用儲存空間如何運作？

共用儲存空間可讓您 根據跨網站資料製定明智決策 不分享使用者資訊 (例如瀏覽記錄或其他個人 資料) 或內嵌網站，或將資料竊取至自己的伺服器。

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

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

可用的 Shared Storage API 輸出閘有：

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

試用 Shared Storage API

網址選擇輸出閘和私人匯總輸出的 Shared Storage API 可供測試。可以在 Chrome 中測試內容選擇功能 Canary/開發人員/Beta 版 M105+ 和 Private Aggregation API 可在以下位置進行測試： Chrome M107+ Canary 和開發人員版。如要測試這個 API，請在 chrome://settings/adPrivacy 中啟用所有廣告隱私權 API。

使用示範

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

此示範是針對廣告客戶、廣告技術 內容發布商或其他第三方服務 提供有關不同發布者的資訊。在示範中 方程式碼會在「發布商 A」和「發布商 B」網站上執行 或個別用途請前往發布商的頁面，瞭解資料在 跨網站關聯

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

如需內容選擇示範 輪播廣告素材、 為已知客戶自訂使用體驗，以及 提供執行 A/B 測試的用途。

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

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

如要檢查您目前所在頁面啟動的「共用儲存空間」工作程式，請前往「來源」的分頁，然後新增「Shared Storage Worklet / Script First statement」事件監聽器中斷點這個中斷點會在啟動時暫停執行初始模組指令碼或短期工作程式。

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

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

互動及分享意見回饋

共用儲存空間提案正在進行討論，因此可能隨時會有變動 如果您試用這個 API 並有意見，請不吝與我們分享。