このページは Cloud Translation API によって翻訳されました。

Key-Value ターゲティング

Key-Value を使用すると、広告ユニットよりも詳細に広告をターゲティングできます。Key-Value の詳細をご確認ください。

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

ターゲティングを設定

Key-Value を指定して、ネットワークのニーズに応じてスロットレベルとページレベルの両方でターゲティングを設定できます。

スロットレベル

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

スロットレベルのターゲティングを使用すると、スロットごとにターゲティングを設定できます。これは、同じページ上の個々のスロットが異なるターゲティングを必要とする場合に便利ですが、同じ Key-Value がすべてのスロットに適用される場合は効率が落ちます。スロットレベルのターゲティングを利用するには、次の例のように Slot.setTarget() を使用します。

ページレベル

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

ページレベルのターゲティングでは、すべての広告スロットに同じ Key-Value セットが設定されます。これにより、ターゲティングの設定に必要なコードの総数が減る場合があります。ページレベルのターゲティングを行うには、次の例に示すように googletag.pubads().setTarget() を使用します。

<head>
  <script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
  <script>
    window.googletag = window.googletag || {cmd: []};

    // GPT slots
    var adSlots = [];

    googletag.cmd.push(function() {
      // 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>

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

スロットレベルとページレベルの両方のターゲティングを使用すると、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());

setTargeting() を呼び出すときに値の配列を指定することで、1 つのキーに複数の値を対象とすることもできます。

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

ターゲティングをクリア

ターゲティングを設定すると、広告スロットの存続期間中は、広告リクエストごとに構成された Key-Value が送信されます。ただし、状況によっては、ターゲティングを徐々に変更するのが望ましい場合があります。setTargeting() を使用して Key-Value の追加や上書きを行うことができますが、この方法で Key-Value を削除することはできません。そのためには、代わりに Slot.clearTarget() または googletag.pubads().clearTarget() を使用する必要があります。

// 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`