Pary klucz-wartość mogą służyć do bardziej szczegółowego kierowania reklam niż przy użyciu jednostek reklamowych. Więcej informacji o parach klucz-wartość.
Dla każdego żądania reklamy możesz przekazać jeden lub więcej kluczy, z których każdy może mieć
powiązane wartości. Te pary klucz-wartość zostaną ocenione pod kątem opcji kierowania
skonfigurowanych w usłudze Ad Manager na poziomie elementu zamówienia. Na przykład, jeśli
przekażesz niestandardową parę klucz-wartość age=18-34, elementy zamówienia kierowane na przedział wiekowy
Reklamy będą mogły się wyświetlać w wieku od 18 do 34 lat, pod warunkiem spełnienia wszystkich pozostałych kryteriów.
Ustaw kierowanie
Możesz określić pary klucz-wartość, by skonfigurować kierowanie zarówno na boks, na poziomie strony, zależnie od potrzeb 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 boksu. Jest to przydatne w przypadkach, gdy poszczególne boksy na tej samej stronie wymagają różne ustawienia kierowania, ale może okazać się nieskuteczne w sytuacjach, gdy ten sam są stosowane we wszystkich boksach. Używaj Slot.setTargeting(), aby korzystać z funkcji na poziomie boksu. jak w przykładzie poniżej.
- Poziom strony
Umożliwia skonfigurowanie par klucz-wartość we wszystkich boksach reklamowych na stronie.
Kierowanie na poziomie strony zapewnia, że wszystkie boksy reklamowe mają ten sam zestaw par klucz-wartość. W niektórych przypadkach może to zmniejszyć całkowitą ilość kodu potrzebnego do skonfigurować kierowanie reklam. Używaj googletag.pubads().setTargeting(), które mają być użyte na poziomie strony, jak w przykładzie poniżej.
<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>
W tym przykładzie zdefiniowano 2 boksy reklamowe, które określają jednostkę reklamową.
/6355419/Travel/Asia i rozmiar reklamy 728x90. Następnie kierowanie na pary klucz-wartość
stosowane w celu dalszego ograniczania i różnicowania reklam, które mogą być wyświetlane
gniazdo.
Jeśli używane jest kierowanie zarówno na poziomie boksu, jak i strony, pary klucz-wartość są łączone i tylko reklamy, które spełniają wszystkie kryteria, będą mogły być wyświetlane w danym boksie. W tym przykładzie efektywne tagowanie dla 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 połączenie kierowania na poziomie boksu i strony służy do definiowania wielu kluczy kierowania dla jednego boksu reklamowego. Oto kilka alternatywne sposoby osiągnięcia tej samej skutecznej skuteczności kierowania:
Tylko kierowanie na poziomie boksu
W tym przykładzie udostępniane pary klucz-wartość są powtarzane w przypadku każdego boksu reklamowego.
// 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 jest ustawione na poziomie strony i zastąpione 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żna również kierować reklamy na wiele wartości dla jednego klucza, przesyłając parametr
tablica 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 przy każdym
żądania reklamy przez cały okres aktywności boksu reklamowego. W pewnych okolicznościach
by ustawienia kierowania
zmieniły się z upływem czasu. Choć setTargeting() może być
do dodawania i zastępowania par klucz-wartość, nie można ich usunąć w ten sposób.
W tym celu użyj funkcji Slot.clearTargeting() lub
googletag.pubads().clearTargeting() musi mieć wartość
.
// 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 klawisza (na poziomie
na poziomie boksu lub strony), usuwany jest tylko ten klucz. Jeśli nie podasz żadnego klucza, wszystkie
kierowanie na tym poziomie.
W poprzednim przykładzie efektywne kierowanie boksu reklamowego po każdym krok to:
| Krok | Skuteczne kierowanie |
|---|---|
| 0 | color=red AND position=atf AND interests=basketball |
| 1 | position=atf AND interests=basketball |
| 2 | position=atf |