Таргетинг на пары "ключ-значение"

Пары «ключ-значение» можно использовать для более детального таргетинга объявлений, чем рекламные блоки. Узнайте больше о ключах и значениях .

Для каждого запроса объявления вы можете передать один или несколько ключей, каждый из которых имеет одно или несколько связанных значений. Эти пары "ключ-значение" будут оцениваться по параметрам таргетинга, настроенным на уровне позиции в Менеджере рекламы. Например, если вы передадите специальный ключ-значение age=18-34 , позиции с таргетингом на возрастной диапазон 18–34 лет будут допущены к показу при условии соответствия всем остальным критериям.

Установить таргетинг

Вы можете указать пары «ключ-значение», чтобы настроить таргетинг как на уровне рекламного места, так и на уровне страницы, в зависимости от потребностей вашей сети.

Уровень слота

Позволяет вам устанавливать пары "ключ-значение" для отдельных рекламных мест на вашей странице.

Таргетинг на уровне рекламных мест позволяет настраивать таргетинг для каждого рекламного места. Это полезно в тех случаях, когда отдельные рекламные места на одной странице требуют разного таргетинга, но может оказаться неэффективным в ситуациях, когда одни и те же пары «ключ-значение» применяются ко всем рекламным местам. Используйте Slot.setTargeting(), чтобы использовать таргетинг на уровне рекламных мест, как показано в следующем примере.

Уровень страницы

Позволяет устанавливать пары "ключ-значение" для всех рекламных мест на вашей странице.

Таргетинг на уровне страниц гарантирует, что все рекламные места имеют одинаковый набор пар «ключ-значение». В некоторых случаях это может уменьшить общий объем кода, необходимого для настройки таргетинга. Используйте 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>

В этом примере определены два рекламных места, в которых указан рекламный блок /6355419/Travel/Asia и размер объявления 728x90 . Затем применяется таргетинг «ключ-значение» для дальнейшего ограничения и дифференциации объявлений, которые могут показываться в каждом слоте.

Если используется таргетинг на уровне рекламного места и страницы, пары "ключ-значение" объединяются, и только объявления, соответствующие всем критериям, могут показываться в данном рекламном месте. В этом примере эффективная маркировка для каждого слота равна:

Рекламное место Эффективный таргетинг
1 color=red AND position=atf AND interests=basketball
2 position=btf AND interests=basketball

Таргетинг на несколько ключей или значений

В предыдущем примере комбинация таргетинга на уровне рекламного места и страницы использовалась для определения нескольких ключей таргетинга для одного рекламного места. Вот несколько альтернативных подходов для достижения такого же эффективного таргетинга:

Таргетинг только на уровне рекламного места

В этом примере общие пары «ключ-значение» повторяются для каждого рекламного места.

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

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

Четкий таргетинг

После настройки таргетинга настроенные пары «ключ-значение» будут отправляться с каждым запросом объявления в течение всего срока действия рекламного места. Однако в некоторых обстоятельствах может оказаться желательным, чтобы таргетирование со временем менялось. Хотя setTargeting() можно использовать для добавления и перезаписи значений ключа, удалить их таким образом невозможно. Для этого необходимо использовать 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