Kierowanie na pary klucz-wartość

Pary klucz-wartość umożliwiają kierowanie bardziej szczegółowe niż kierowanie na jednostki reklamowe. Dowiedz się więcej o parach klucz-wartość.

W przypadku każdego żądania reklamy możesz przekazać jeden lub więcej kluczy, a z każdym z nich powiązanych wartości. Pary klucz-wartość zostaną ocenione pod kątem opcji kierowania skonfigurowanych na poziomie elementu zamówienia w usłudze Ad Manager. Jeśli na przykład przekażesz niestandardową parę klucz-wartość age=18-34, elementy zamówienia kierowane na przedział wiekowy 18–34 będą mogły się wyświetlać, pod warunkiem że wszystkie pozostałe kryteria będą pasować.

Ustaw kierowanie

Możesz określić pary klucz-wartość, aby skonfigurować kierowanie na poziomie boksu i strony zgodnie z potrzebami Twojej sieci.

Na poziomie boksu

Umożliwia skonfigurowanie par klucz-wartość dla poszczególnych boksów reklamowych na stronie.

Kierowanie na poziomie boksu umożliwia konfigurowanie kierowania na poziomie konkretnego boksu. Jest to przydatne w przypadkach, gdy poszczególne boksy na tej samej stronie wymagają różnych ustawień kierowania, ale mogą być nieskuteczne w sytuacjach, gdy te same pary klucz-wartość są stosowane do wszystkich boksów. Użyj funkcji Slot.set Targeting(), aby zastosować kierowanie na poziomie boksu, jak pokazano w poniższym przykładzie.

Na poziomie strony

Umożliwia skonfigurowanie par klucz-wartość we wszystkich boksach reklamowych na stronie.

Kierowanie na poziomie strony powoduje, że wszystkie boksy reklamowe mają ten sam zestaw par klucz-wartość. W niektórych przypadkach może to ograniczyć łączną ilość kodu potrzebnego do skonfigurowania kierowania. Użyj funkcji googletag.pubads().set Targeting(), aby zastosować kierowanie na poziomie strony, jak w przykładzie poniżej.

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

W tym przykładzie są zdefiniowane 2 boksy reklamowe, które określają jednostkę reklamową /6355419/Travel/Asia i rozmiar reklamy 728x90. Następnie kierowanie według par klucz-wartość służy do dalszego ograniczania i rozróżniania reklam, które mogą się wyświetlać w danym boksie.

Jeśli korzystasz z kierowania na poziomie boksu i strony, pary klucz-wartość są łączone i tylko reklamy spełniające wszystkie kryteria mogą się wyświetlić w danym boksie. W tym przykładzie skuteczne tagowanie w przypadku każdego boksu to:

Boks reklamowy Skuteczne kierowanie
1 color=red AND position=atf AND interests=basketball
2 position=btf AND interests=basketball

Kierowanie na wiele kluczy lub wartości

W poprzednim przykładzie do określenia wielu kluczy kierowania dla jednego boksu reklamowego użyto kombinacji kierowania na poziomie boksu i strony. Oto kilka alternatywnych metod pozwalających osiągnąć takie samo kierowanie:

Tylko kierowanie na poziomie boksu

W tym przykładzie wspólne pary klucz-wartość powtarzają się w każdym boksie reklamowym.

// 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');

Domyślne kierowanie na poziomie strony

W tym przykładzie kierowanie domyślne zostało ustawione na poziomie strony, a w razie potrzeby zastąpiono je na poziomie boksu.

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

Możesz też ustawić kierowanie na wiele wartości dla jednego klucza, podając tablicę wartości podczas wywoływania funkcji setTargeting():

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

Wyczyść kierowanie

Po ustawieniu kierowania skonfigurowane pary klucz-wartość będą wysyłane wraz z każdym żądaniem reklamy w cyklu życia boksu reklamowego. W niektórych przypadkach może jednak być korzystne, że z czasem kierowanie ulegnie zmianie. Za pomocą setTargeting() można dodawać i zastępować pary klucz-wartość, ale nie można ich w ten sposób usunąć. Aby to zrobić, użyj funkcji Slot.clear Targeting() lub googletag.pubads().clear Targeting().

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

Gdy funkcja clearTargeting() jest wywoływana za pomocą określonego klucza (na poziomie boksu lub strony), usuwany jest tylko ten klucz. Jeśli nie określisz klucza, wszystkie ustawienia kierowania na tym poziomie zostaną usunięte.

W poprzednim przykładzie efektywne kierowanie na boks reklamowy po każdym kroku to:

Krok Skuteczne kierowanie
0 color=red AND position=atf AND interests=basketball
1 position=atf AND interests=basketball
2 position=atf