使用共用儲存空間小程式識別已知客戶。
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 this.sharedStorage.get('known-customer');
// '0' is unknown and '1' is known
return parseInt(knownCustomer);
}
}
register('known-customer', SelectURLOperation);
應用情境
以上只是其中一部分的共用儲存空間用途。在收到意見回饋及發掘新的用途的同時,我們會繼續新增範例。
內容篩選
根據在共用儲存空間中收集到的資訊,在圍欄頁框中選取及顯示不同網站上的不同內容。這些用途的輸出門檻是選取網址。
- 廣告素材輪播:儲存資料 (例如廣告素材 ID、觀看次數和使用者互動),以判斷使用者會在各網站上看到哪些廣告素材。
- A/B 測試:您可以將使用者指派給實驗群組,然後將該群組儲存在共用儲存空間中,方便跨網站存取。
- 自訂使用者體驗:根據使用者的註冊狀態或其他使用者狀態,分享自訂內容和行動號召
產生摘要報表
使用「共用儲存空間」收集資訊,並產生雜訊的匯總報表。這些用途的輸出閘門是 Private Aggregation API。
- 不重複觸及率評估:許多內容製作者和廣告客戶會想瞭解有多少不重複觀眾看過他們的內容。使用 Shared Storage 可記錄使用者首次看見您的廣告、內嵌影片或出版品,並防止同一位使用者在不同網站上重複計算。接著,您可以使用 Private Aggregation API 輸出觸及率的摘要報表。
- 客層評估:內容製作者通常會想瞭解觀眾的客層。您可以使用共用儲存空間,在您擁有的位置 (例如第一方網站) 記錄使用者客層資料,並使用匯總報表製作其他許多網站的報表,例如嵌入內容。
- K+ 頻率評估:有時又稱為「有效頻率」,通常在使用者辨識或想起某些內容前,通常會需要觀看最低次數 (通常以廣告檢視畫面來說)。您可以使用共用儲存空間,針對曾看過內容片段超過 K 次的不重複使用者人數建立報表。
互動及分享意見回饋
共用儲存空間提案正在進行討論,因此可能隨時會有變動 如果您試用這個 API 並有意見,請不吝與我們分享。
- GitHub:閱讀 提案、觸及白皮書、提出疑問並參與討論。
- Shared Storage API 公告:加入或查看我們的郵寄清單過往公告
- 開發人員支援:您可以提問或參與 Privacy Sandbox 開發人員支援存放區。