使用共用儲存空間小程式識別已知客戶。
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 版本測試:您可以將使用者指派給實驗群組,然後將該群組儲存在共用儲存空間中,以便跨網站存取。
- 自訂使用者體驗:根據使用者的註冊狀態或其他使用者狀態,分享自訂內容和行動號召
產生摘要報表
使用 Shared Storage 收集資訊,並產生雜訊匯總摘要報表。這些用途的輸出閘道為 Private Aggregation API。
- 不重複觸及評估:許多內容製作者和廣告客戶都想知道有多少不重複使用者觀看了他們的內容。使用共用儲存空間記錄使用者首次看到廣告、嵌入的影片或刊登內容,並避免在不同網站上重複計算同一使用者的次數。接著,您可以使用 Private Aggregation API 輸出觸及數的摘要報表。
- 客層評估:內容製作者通常會想瞭解觀眾的客層。您可以使用 Shared Storage,在第一方網站等有使用者客層資料的環境中記錄使用者客層資料,並使用匯總報表,針對許多其他網站 (例如嵌入內容) 回報這項資料。
- K+ 頻率評估:有時稱為「有效展示頻率」,使用者必須看到一定次數的廣告,才會認出或回想特定內容 (通常是在廣告觀看的情況下)。您可以使用 Shared Storage,針對至少看過 K 次內容的不重複使用者建立報表。
互動並分享意見回饋
請注意,Shared Storage API 提案仍在積極討論和開發中,因此可能會有變動。
我們很期待聽到您對 Shared Storage API 的想法。
掌握最新消息
- 電子報:訂閱我們的電子報,即可取得與 Shared Storage API 相關的最新消息和公告。
需要協助嗎?
- 開發人員支援:在 Privacy Sandbox 開發人員支援存放區中與其他開發人員互動,並取得問題解答。