Key-Value ターゲティング

Key-Value を使用すると、広告ユニットよりもきめ細かく広告のターゲットを設定できます。詳細 Key-Value の詳細をご覧ください。

広告リクエストごとに 1 つ以上のキーを渡すことができます。各キーには 1 つ以上のキーを表示されます。これらの Key-Value はターゲティングオプションと照らし合わせて評価されますアドマネージャーでは広告申込情報レベルで 1,000 件ずつですたとえばカスタム Key-Value「age=18-34」を渡します。これは、年齢層をターゲットとする広告申込情報です。他のすべての条件に一致した場合、18 ～ 34 歳のユーザーも広告を配信できます。

ターゲティングの設定

Key-Value を指定して、スロットとページ単位で自動的に設定を適用できます

スロットレベル

ページ上の個々の広告スロットに Key-Value を設定できます。

スロットレベルのターゲティングを使用すると、スロット単位でターゲティングを設定できます。これは、同じページの個々のスロットでターゲティングが異なるものの、同じものが複数のすべてのスロットに適用されます使用 Slot.setTargeting(): スロットレベルを利用追加します。

ページレベル

ページのすべての広告スロットに Key-Value を設定できます。

ページレベルターゲティングを使用すると、すべての広告スロットで同じセットの Key-Value場合によっては、これにより、ソフトウェア開発に必要なコードの総量がターゲティングを構成します。使用 googletag.pubads().setTargeting(): ページレベルのターゲティングを設定できます。

<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta
      name="description"
      content="Use key-value targeting to control the ads eligible to serve to specific ad slots."
    />
    <title>Key-value targeting</title>
    <script
      async
      src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"
      crossorigin="anonymous"
    ></script>
    <script>
      window.googletag = window.googletag || { cmd: [] };

      // GPT slots
      let adSlots = [];

      googletag.cmd.push(() => {
        // Configure slot-level targeting.
        adSlots[0] = googletag
          .defineSlot("/6355419/Travel/Asia", [728, 90], "banner-ad-1")
          .addService(googletag.pubads())
          .setTargeting("color", "red")
          .setTargeting("position", "atf");
        adSlots[1] = googletag
          .defineSlot("/6355419/Travel/Asia", [728, 90], "banner-ad-2")
          .addService(googletag.pubads())
          .setTargeting("position", "btf");

        // Configure page-level targeting.
        googletag.pubads().setTargeting("interests", "basketball");

        // Enable SRA and services.
        googletag.pubads().enableSingleRequest();
        googletag.enableServices();
      });
    </script>
</head>

この例では、広告ユニットを指定する 2 つの広告スロットが定義されています。 /6355419/Travel/Asia、広告サイズは 728x90 です。Key-Value ターゲティングは適用される広告をさらに制限して区別するためにあります。

スロットレベルとページレベルの両方のターゲティングを使用すると、すべての条件を満たす広告のみが特定のスロットに配信されますこの例では、各スロットの効果的なタグ付けは次のとおりです。

広告スロット	効果的なターゲティング
1	`color=red AND position=atf AND interests=basketball`
2	`position=btf AND interests=basketball`

複数のキーまたは値をターゲットにする

上の例では、スロットレベルとページレベルのターゲティングを組み合わせて、 1 つの広告スロットに複数のターゲティングキーを定義する際に使用します。以下に例を示します。同様の効果的なターゲティングを実現できる

スロットレベルのターゲティングのみ

この例では、共有 Key-Value が広告スロットごとに繰り返されています。

// Slot-level targeting with multiple keys.
adSlots[0] = googletag
    .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-1')
    .addService(googletag.pubads())
    .setTargeting('color', 'red')
    .setTargeting('position', 'atf')
    .setTargeting('interests', 'basketball');
adSlots[1] = googletag
    .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-2')
    .addService(googletag.pubads())
    .setTargeting('position', 'btf')
    .setTargeting('interests', 'basketball');

ページレベルのデフォルトのターゲティング

この例では、デフォルトのターゲティングがページレベルで設定され、オーバーライドされていますスロットレベルで適用することもできます

// Page-level default targeting.
googletag.pubads().setTargeting('interests', 'basketball')
                  .setTargeting('position', 'btf');

// Slot-level targeting overrides.
adSlots[0] = googletag
    .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-1')
    .addService(googletag.pubads())
    .setTargeting('color', 'red')
    .setTargeting('position', 'atf');
adSlots[1] = googletag
    .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-2')
    .addService(googletag.pubads());

次のように指定して、1 つのキーに複数の値をターゲットにすることもできます。 setTargeting() を呼び出す際の値の配列:

// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);

ターゲティングをクリア

ターゲティングが設定されると、設定済みの Key-Value は 100 日継続すると 100 を超える広告リクエストが発生しますただし、場合によっては経時的に変化するターゲティングが理想的ですsetTargeting() は Key-Value の追加や上書きに使用されている場合、この方法では削除できません。そのためには、Slot.clearTargeting() または googletag.pubads().clearTargeting() は使用します。

// Step 0, define slot- and page-level targeting.
  adSlots[0] = googletag
    .defineSlot("/6355419/Travel/Asia", [728, 90], "banner-ad-1")
    .addService(googletag.pubads())
    .setTargeting("color", "red")
    .setTargeting("position", "atf");

  googletag.pubads().setTargeting("interests", "basketball");

  // Step 1, clear slot-level color targeting.
  adSlots[0].clearTargeting("color");

  // Step 2, clear all page-level targeting.
  googletag.pubads().clearTargeting();

clearTargeting() が特定のキー（またはそのキーのみが削除されます。鍵が指定されていない場合は、そのレベルのターゲティングは削除されます

上の例では、各エントリの後に広告スロットの有効なターゲティングが次のとおりです。

ステップ	効果的なターゲティング
0	`color=red AND position=atf AND interests=basketball`
1	`position=atf AND interests=basketball`
2	`position=atf`