執行「共用儲存空間」小程式,選取網址並在圍欄頁框中顯示。
Shared Storage API 是 Privacy Sandbox 提案之一,適用於一般用途的跨網站儲存空間。這個 API 支援許多可能的用途。例如展示頻率控制,可在 Chrome Beta 104.0.5086.0 以上版本中進行測試。
執行 Worklet 指令碼,根據儲存的資料從提供的清單中選取網址,然後在 Fenced 影格中轉譯該網址。達到頻率限制時,這項功能可用來選取新的廣告或其他內容。
根據頻率測試廣告素材選擇
如要透過共用儲存空間和 Fenced Frames 測試依頻率選擇廣告素材的效果,請確認您使用的是 Chrome 104.0.5086.0 以上版本。接著,在 chrome://flags/#privacy-sandbox-ads-apis
中啟用 Privacy Sandbox Ads API 實驗標記。
您也可以在指令列中使用 --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
旗標啟用「共用儲存空間」。
使用程式碼範例進行實驗
如要選取並建立不透明的網址,請註冊 Worklet 模組來讀取共用儲存空間資料。此 Worklet 類別會收到最多八個網址的清單,然後傳回所選網址的索引。
當用戶端呼叫 sharedStorage.selectURL()
時,工作小程式會執行並傳回不透明網址,以轉譯到圍欄頁框中。
假設您想要根據使用者看到廣告的頻率,選取不同的廣告或內容。您可以計算使用者觀看內容的次數,並將該值儲存在共用儲存空間中。儲存後,不同來源就能使用共用儲存空間中的值。
接著,共用儲存工作小程式會讀取共用儲存空間中的值,並隨著每次額外檢視增加計數器。如果數量未達預先定義的上限,系統會傳回您要轉譯的內容 (索引 1
)。否則,系統會傳回預設網址 (索引 0
)。
在這個例子中:
creative-selection-by-frequencyjs
是透過內容製作者或廣告客戶的 iframe 載入,並負責載入共用儲存空間工作小程式,並將傳回的不透明來源算繪到圍欄頁框。creative-selection-by-frequency-worklet.js
是共用儲存小程式,可讀取頻率計數,以判定系統為內容或廣告素材傳回哪個網址。
creative-selection-by-frequency.js
// The first URL is the default content or ad to be rendered when the frequency limits reached.
const CONTENT_URLS = [
{ url: `https://${contentProducerUrl}/default-content.html` },
{ url: `https://${contentProducerUrl}/example-content.html` },
];
async function injectAd() {
// Load the worklet module.
await window.sharedStorage.worklet.addModule('creative-selection-by-frequency-worklet.js');
// Set the initial frequency count
window.sharedStorage.set('frequency-count', 0, {
ignoreIfPresent: true,
});
// Run the URL selection operation to choose an ad based on the frequency count in shared storage.
const fencedFrameConfig = await window.sharedStorage.selectURL('creative-selection-by-frequency', CONTENT_URLS, {
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('content-slot').config = fencedFrameConfig;
}
injectAd();
creative-selection-by-frequency-worklet.js
const FREQUENCY_LIMIT = 5;
class CreativeSelectionByFrequencyOperation {
async run(urls, data) {
// Read the current frequency limit in shared storage
const count = parseInt(await this.sharedStorage.get('frequency-count'));
// Check if the frequency limit has been reached.
if (count === FREQUENCY_LIMIT) {
console.log('Frequency limit has been reached, and the default content will be rendered.');
return 0;
}
// Set the new frequency count in shared storage
await this.sharedStorage.set('frequency-count', count + 1);
return 1;
}
}
// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);
應用情境
以上只是其中一部分的共用儲存空間用途。在收到意見回饋及發掘新的用途的同時,我們會繼續新增範例。
內容篩選
根據在共用儲存空間中收集到的資訊,在圍欄頁框中選取及顯示不同網站上的不同內容。這些用途的輸出門檻是選取網址。
- 廣告素材輪播:儲存資料 (例如廣告素材 ID、觀看次數和使用者互動),以判斷使用者會在各網站上看到哪些廣告素材。
- A/B 測試:您可以將使用者指派給實驗群組,然後將該群組儲存在共用儲存空間中,方便跨網站存取。
- 自訂使用者體驗:根據使用者的註冊狀態或其他使用者狀態,分享自訂內容和行動號召
產生摘要報表
使用「共用儲存空間」收集資訊,並產生雜訊的匯總報表。這些用途的輸出閘門是 Private Aggregation API。
- 不重複觸及率評估:許多內容製作者和廣告客戶會想瞭解有多少不重複觀眾看過他們的內容。使用 Shared Storage 可記錄使用者首次看見您的廣告、內嵌影片或出版品,並防止同一位使用者在不同網站上重複計算。接著,您可以使用 Private Aggregation API 輸出觸及率的摘要報表。
- 客層評估:內容製作者通常會想瞭解觀眾的客層。您可以使用共用儲存空間,在您擁有的位置 (例如第一方網站) 記錄使用者客層資料,並使用匯總報表製作其他許多網站的報表,例如嵌入內容。
- K+ 頻率評估:有時又稱為「有效頻率」,通常在使用者辨識或想起某些內容前,通常會需要觀看最低次數 (通常以廣告檢視畫面來說)。您可以使用共用儲存空間,針對曾看過內容片段超過 K 次的不重複使用者人數建立報表。
交流及分享意見回饋
共用儲存空間提案仍在進行中的討論,日後可能會有變動。如果您試用這個 API,並有任何意見,歡迎與我們分享。
- GitHub:閱讀提案、提出疑問並參與討論。
- Shared Storage API 公告:透過郵寄清單加入或查看過去的公告
- 開發人員支援:在 Privacy Sandbox 開發人員支援存放區中提問及參與討論。