執行共用儲存空間工作程式來選取網址,並在圍欄頁框中顯示該網址。
Shared Storage API 是適用於一般用途的跨網站儲存空間 Privacy Sandbox 提案,可支援許多可能的用途。其中一個範例就是頻率控制,可在 Chrome Beta 版 104.0.5086.0 以上版本中進行測試。
執行 Worklet 指令碼,根據儲存的資料從提供的清單中選取網址,然後在圍欄頁框中轉譯該網址。達到展示頻率上限時,可用來選取新廣告或其他內容。
依頻率測試廣告素材選擇
如要使用共用儲存空間和 Fenced Frames 測試廣告素材選取頻率,請確認使用的是 Chrome 104.0.5086.0 以上版本。啟用 chrome://settings/adPrivacy
下的所有廣告隱私權 API。
您也可以在指令列中使用 --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
旗標啟用共用儲存空間。
使用程式碼範例進行實驗
如要選取並建立不透明網址,請註冊 Worklet 模組來讀取共用儲存空間資料。Worklet 類別會收到最多 8 個網址的清單,然後傳回所選網址的索引。
當用戶端呼叫 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 開發人員支援存放區。