広告クリエイティブをローテーションで表示する

共有ストレージを使用して、複数のサイトでユーザーに表示されるクリエイティブを決定します。

Shared Storage API はプライバシー さまざまな用途をサポートする汎用のクロスサイト ストレージ向けのサンドボックス案 見ていきましょう。その一例がクリエイティブ ローテーションです。 Chrome 104.0.5086.0 以降でテストできます。

クリエイティブ ローテーションでは、クリエイティブ ID、ビューなどのデータを保存できます。 カウント、ユーザー操作に基づき、どのクリエイティブ ユーザーが全体の表示 できます。

共有ストレージ ワークレットを実行して、 そのクリエイティブをフェンスで囲まれた フレーム内にレンダリングしますこれは 広告などのコンテンツを選択します

クリエイティブ ローテーションをお試しください

共有ストレージでクリエイティブ ローテーションをテストするには、Chrome 104.0.5086.0 以降を使用していることを確認してください。chrome://settings/adPrivacy で、すべての広告プライバシー API を有効にします。

コマンドラインで --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames フラグを使用して共有ストレージを有効にすることもできます。

コードサンプルでテストする

広告主やコンテンツ制作者は、動画に対して異なる戦略を適用し、 コンテンツまたはクリエイティブをローテーションして効果を高める。 共有ストレージは、次のようなさまざまなローテーション戦略の実行に使用できます。 異なるサイト間での順次ローテーションと均等に分散ローテーションの両方をサポートします。

この例では、次のようになります。

  • creative-rotation.js はフレームに埋め込まれています。このスクリプトは、最も重要な広告（ウェイト）を設定し、ワークレットを呼び出して、表示するコンテンツを決定します。
  • creative-rotation-worklet.js は、コンテンツの加重分布と表示する戻り値を決定する共有ストレージ ワークレットです。

creative-rotation.js

// Ad config with the URL of the content, a probability weight for rotation, and the clickthrough rate.
const DEMO_CONTENT_CONFIG = [
  {
    url: 'https://your-server.example/contents/content-1.html',
    weight: 0.7,
  },
  {
    url: 'https://your-server.example/contents/content-2.html',
    weight: 0.2,
  },
  {
    url: 'https://your-server.example/contents/content-3.html',
    weight: 0.1,
  },
];

// Set the mode to sequential and set the starting index to 0.
async function seedStorage() {
  await window.sharedStorage.set('content-rotation-mode', 'sequential', {
    ignoreIfPresent: true,
  });

  await window.sharedStorage.set('content-rotation-index', 0, {
    ignoreIfPresent: true,
  });
}

async function injectAd() {
  // Load the worklet module
  await window.sharedStorage.worklet.addModule('content-rotation-worklet.js');

  // Initially set the storage to sequential mode for the demo
  seedStorage();

  // Run the URL selection operation to determine the next content rendered.
  const urls = DEMO_CONTENT_CONFIG.map(({ url }) => ({ url }));
  const fencedFrameConfig = await window.sharedStorage.selectURL('content-rotation', urls, { 
    data: DEMO_CONTENT_CONFIG,
    resolveToConfig: true
  });

  // Render the opaque URL into a fenced frame
  document.getElementById('content-slot').config = fencedFrameConfig;
}

injectAd();

creative-rotation-worklet.js

class SelectURLOperation {
  async run(urls, data) {
    // Read the rotation mode from Shared Storage
    const rotationMode = await sharedStorage.get('content-rotation-mode');

    // Generate a random number to be used for rotation
    const randomNumber = Math.random();

    let index;

    switch (rotationMode) {
      /**
       * Sequential rotation
       * - Rotates the contents in order
       * - Example: A -> B -> C -> A ...
       */
      case 'sequential':
        const currentIndex = await sharedStorage.get('creative-rotation-index');
        index = parseInt(currentIndex, 10);
        const nextIndex = (index + 1) % urls.length;

        await sharedStorage.set('content-rotation-index', nextIndex);
        break;

      /**
       * Weighted rotation
       * - Rotates the contentswith weighted probability
       * - Example: A=70% / B=20% / C=10%
       */
      case 'weighted-distribution':
        
        // Sum the weights cumulatively, and find the first URL where the
        // sum exceeds the random number. The array is sorted in
        // descending order first.
        let weightSum = 0;
        const { url } = data
          .sort((a, b) => b.weight - a.weight)
          .find(({ weight }) => {
            weightSum += weight;
            return weightSum > randomNumber;
          });

        index = urls.indexOf(url);
        break;

      default:
        index = 0;
    }
    return index;
  }
}

register('content-rotation', SelectURLOperation);

ユースケース

これらは、共有ストレージの考えられるユースケースのほんの一部にすぎません。Google では、 例を追加しながら フィードバックを受け取る 新しいユースケースを発見できます

コンテンツの選択

ウェブサイトごとに異なるコンテンツを選択して表示 フェンス付きフレーム 収集されます。これらのユースケースの出力ゲートは URL の選択です。

  • クリエイティブ ローテーション: クリエイティブ ID、表示回数、ユーザー インタラクションなどのデータを保存し、どのクリエイティブ ユーザーが異なるサイト間で表示されます。
  • A/B テスト: ユーザーをテスト グループに割り当てて、そのグループを共有ストレージに保存すれば、クロスサイトからアクセスできるようになります。
  • カスタム ユーザー エクスペリエンス: ユーザーの登録ステータスや他のユーザーのステータスに基づいて、カスタム コンテンツや行動を促すフレーズを共有する

概要レポートを生成する

共有ストレージを使用して情報を収集し、ノイズの多い集計済み概要レポートを生成します。これらのユースケースの出力ゲートは、 Private Aggregation API。

  • ユニークリーチ測定: 多くのコンテンツ制作者や広告主は、ユニーク視聴者数を 表示されました。共有ストレージを使用して初回ユーザーを記録する ユーザーが広告、埋め込み動画、パブリケーションを見て、コンテンツの重複を防ぐ 同じユーザーを異なるサイトで カウントする場合もありますPrivate Aggregation API を使用して、リーチの概要レポートを生成できます。
  • ユーザー属性の測定: コンテンツ制作者は多くの場合、自分の動画のユーザー属性を できます。共有ストレージを使用すると、ユーザー属性データを 1 か所で記録できます。 所有するコンテキスト（ファーストパーティ サイトなど）を取得し、集計された 他の多くのサイト（埋め込みコンテンツなど）でもレポートを作成できます。
  • K+ 頻度測定: 「有効フリークエンシー」とも呼ばれる多くの場合、最小権限の原則が 視聴してから特定のコンテンツ（ （広告ビューのコンテキスト）共有ストレージを使用してレポートを作成する コンテンツを K 回以上視聴したユニーク ユーザーの割合。

対応してフィードバックを共有する

共有ストレージの提案は現在検討中であり、変更される可能性があります 使用できます。この API をお試しいただき、ご意見やご感想がございましたら、ぜひお聞かせください。