依頻率選取廣告素材

執行共用儲存空間小程式，選取網址並在設有圍欄的影格中算繪。

Shared Storage API 是 Privacy Sandbox 提案，提供一般用途的跨網站儲存空間，支援多種可能用途。例如，您可以在 Chrome Beta 版 104.0.5086.0 以上版本中測試頻率控制功能。

執行工作小程式指令碼，根據儲存的資料從提供的清單中選取網址，然後在設有圍欄的影格中算繪該網址。達到頻率限制時，系統會使用這項功能選取新廣告或其他內容。

依頻率測試廣告素材選取

如要使用 Shared Storage 和 Fenced Frames 測試依頻率選取素材資源，請確認您使用的是 Chrome 104.0.5086.0 以上版本。啟用 chrome://settings/adPrivacy 下的所有廣告隱私權 API。

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

試用程式碼範例

如要選取及建立不透明網址，請註冊用來讀取共用儲存空間資料的 Worklet 模組。小程式類別會收到最多八個網址的清單，然後傳回所選網址的索引。

用戶端呼叫 sharedStorage.selectURL() 時，工作單元會執行並傳回不透明的網址，以便在封閉架構中算繪。

假設您想根據使用者先前觀看廣告或內容的頻率，選取要顯示的廣告或內容。您可以計算使用者觀看內容的次數，並將該值儲存在共用儲存空間中。儲存後，您就能在不同來源中使用共用儲存空間中的值。

接著，共用儲存空間工作單會讀取共用儲存空間中的值，並在每次額外瀏覽時遞增計數器。如果計數尚未達到預先定義的限制，系統會傳回要算繪的內容 (索引 1)。否則，系統會傳回預設網址 (索引 0)。

在這個例子中：

  • creative-selection-by-frequencyjs 是透過內容製作人或廣告主的 iframe 載入，負責載入共用儲存空間 Worklet，並將傳回的不透明來源轉譯為設有安全防護的影格。
  • 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 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 sharedStorage.set('frequency-count', count + 1);
    return 1;
  }
}

// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);

用途

請參閱本節，瞭解 Select URL API 的所有可用用途。我們會持續新增示例，以回應使用者意見並探索新的測試案例。

Engage and share feedback

Note that the Select URL API proposal is under active discussion and development and subject to change.

We're eager to hear your thoughts on the Select URL API.