為已知客戶自訂使用者體驗

使用共用儲存空間小程式來識別已知客戶。

Shared Storage API 是 Privacy Sandbox 提案之一，適用於一般用途的跨網站儲存空間。這個 API 支援許多可能的用途。例如找出已知客戶，並在 Chrome 104.0.5086.0 以上版本中進行測試。

您可以儲存使用者是否已在您的網站註冊共用儲存空間，然後根據使用者是否儲存的狀態 (使用者是否為「已知」客戶) 算繪個別元素。

設定已知客戶

如要嘗試在共用儲存空間中找出已知客戶，請確認您使用的是 Chrome 104.0.5086.0 以上版本。接著，在 chrome://flags/#privacy-sandbox-ads-apis 中啟用 Privacy Sandbox Ads API 實驗標記。

將 Privacy Sandbox Ads API 實驗設為啟用以使用這些 API

您也可以在指令列中使用 --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames 旗標啟用「共用儲存空間」。

使用程式碼範例進行實驗

您可以根據使用者是否出現在其他網站，顯示不同的元素。舉例來說，付款服務供應商可根據使用者是否在付款服務供應商的網站上註冊，顯示「註冊」或「立即購買」按鈕。您可以使用共用儲存空間設定使用者的狀態，並根據該狀態自訂使用者體驗。

在這個例子中：

  • known-customer.js 已嵌入在頁框中。這段指令碼會設定網站中顯示的「註冊」或「立即購買」按鈕選項。
  • known-customer-worklet.js 是決定使用者是否已知使用者的共用儲存空間小程式。如果已知使用者，則會傳回資訊。使用者未知時，系統會傳回該資訊並顯示「註冊」按鈕，並將使用者標示為未來已知。

已知-customer.js

// 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();

known-customer-worklet.js

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，並有任何意見，歡迎與我們分享。