使用共用儲存空間小程式識別已知客戶。
Shared Storage API 是一項「隱私權」 一般用途的沙箱提案,支援多種 可能的用途其中一個例子是找出已知客戶 適用於 Chrome 104.0.5086.0 以上版本。
您可以用儲存的方式,儲存使用者是否已在網站上註冊「共用儲存空間」。 然後根據使用者的儲存狀態 ( 「已知」使用者客戶)。
設定已知顧客
如要嘗試在共用儲存空間中找出已知客戶,請確認您使用的是 Chrome 104.0.5086.0 以上版本。啟用 chrome://settings/adPrivacy
下的所有廣告隱私權 API。
您也可以在指令列中使用 --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
旗標啟用共用儲存空間。
使用程式碼範例進行實驗
您可以根據使用者是否是在其他網站上看到不同元素,舉例來說,付款服務供應商可能想顯示「註冊」或「立即購買」按鈕,顯示使用者是否已在付款服務供應商網站上註冊。共用儲存空間可用來設定使用者狀態,並根據該狀態自訂使用者體驗。
在這個例子中:
- 「
known-customer.js
」已嵌入頁框中。這個指令碼會設定網站「註冊」網站上應顯示哪個按鈕的選項或「立即購買」等 known-customer-worklet.js
是決定使用者是否認識的共用儲存空間工作程式。如果已知使用者,則會傳回資訊。如果使用者不明,則會傳回資訊,顯示「Register」,這樣使用者就會標記為未來已知。
// The first URL for the "register" button is rendered for unknown users.
const BUTTON_URLS = [
{ url: `https://${advertiserUrl}/ads/register-button.html` },
{ url: `https://${advertiserUrl}/ads/buy-now-button.html` },
];
async function injectButton() {
// Load the worklet module
await window.sharedStorage.worklet.addModule('known-customer-worklet.js');
// Set the initial status to unknown ('0' is unknown and '1' is known)
window.sharedStorage.set('known-customer', 0, {
ignoreIfPresent: true,
});
// Run the URL selection operation to choose the button based on the user status
const fencedFrameConfig = await window.sharedStorage.selectURL('known-customer', BUTTON_URLS, {
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('button-slot').src = fencedFrameConfig;
}
injectButton();
class SelectURLOperation {
async run(urls) {
const knownCustomer = await sharedStorage.get('known-customer');
// '0' is unknown and '1' is known
return parseInt(knownCustomer);
}
}
register('known-customer', SelectURLOperation);
用途
這些只是「共用儲存空間」的其中一種用途。我們會 也會繼續加入範例 接收意見回饋 並探索新的用途
內容篩選
在多個網站上選擇並顯示不同內容: 「共用儲存空間」中所收集的資料這些用途的輸出閘門是網址選擇。
- 廣告素材輪播: 儲存資料 (例如廣告素材 ID、觀看次數和使用者互動),判斷哪些廣告素材使用者可以跨網站監控
- A/B 測試: 您可以為使用者指派一個實驗群組,然後將該群組儲存在「共用儲存空間」中,以便跨網站存取。
- 自訂使用者體驗: 根據使用者的註冊狀態或其他使用者狀態分享自訂內容和行動號召
產生摘要報表
使用「共用儲存空間」收集資訊,並產生雜訊的匯總摘要報表。這些用途的輸出閘門是 Private Aggregation API。
- Unique Reach 評估: 許多內容製作者和廣告客戶都想知道有多少獨有的 觀眾收看了自己的內容使用共用儲存空間記錄使用者首次記錄 觀看您的廣告、嵌入影片或出版品,並防止重複 計算同一名使用者在不同網站上出現的相同曝光次數接著,您可以使用 Private Aggregation API 輸出觸及率的摘要報表。
- 客層評估: 內容製作者往往會想瞭解自己的觀眾客層 目標對象您可以使用共用儲存空間,記錄以下項目的使用者客層資料: 而是以您擁有的環境 (如第一方網站) 使用匯總資料 製作相關報表,製作其他多個網站上的報表,例如嵌入的內容。
- K+ 頻率評估: 有時也稱為「有效展示頻率」通常具有最小值 在使用者辨識或召回特定內容之前 (通常是 廣告瀏覽的背景資訊)。你可以使用共用儲存空間建立報表 有多少不重複使用者看過某內容至少 K 次。
互動及分享意見回饋
共用儲存空間提案正在進行討論,因此可能隨時會有變動 如果您試用這個 API 並有意見,請不吝與我們分享。
- GitHub:閱讀 提案、觸及白皮書、提出疑問並參與討論。
- Shared Storage API 公告:加入或查看我們的郵寄清單過往公告
- 開發人員支援:您可以提問或參與 Privacy Sandbox 開發人員支援存放區。