Le coppie chiave-valore possono essere utilizzate per scegliere il target degli annunci in modo più granulare rispetto alle unità pubblicitarie. Scopri di più sulle coppie chiave-valore.
Per ogni richiesta di annuncio, puoi passare una o più chiavi, ciascuna con uno o più valori associati. Queste coppie chiave-valore verranno valutate in base alle opzioni di targeting
configurate a livello di elemento pubblicitario in Ad Manager. Ad esempio, se trasmetti una coppia chiave-valore personalizzata age=18-34, gli elementi pubblicitari indirizzati alla fascia d'età 18-34 saranno idonei alla pubblicazione, a patto che tutti gli altri criteri siano soddisfatti.
Impostare il targeting
Puoi specificare coppie chiave-valore per configurare il targeting sia a livello di area annuncio sia a livello di pagina in base alle esigenze della tua rete.
- A livello di slot
Ti consente di impostare coppie chiave-valore per le singole aree annuncio nella pagina.
Il targeting a livello di area annuncio ti consente di configurare il targeting in base a ogni area annuncio. Questo è utile nei casi in cui i singoli slot della stessa pagina richiedono un targeting diverso, ma può essere inefficiente in situazioni in cui le stesse coppie chiave-valore vengono applicate a tutti gli slot. Utilizza Slot.setTargeting() per utilizzare il targeting a livello di slot, come nell'esempio seguente.
- A livello di pagina
Ti consente di impostare coppie chiave-valore in tutte le aree annuncio della pagina.
Il targeting a livello di pagina garantisce che tutte le aree annuncio abbiano lo stesso insieme di coppie chiave-valore. In alcuni casi, questo potrebbe ridurre la quantità totale di codice necessaria per configurare il targeting. Utilizza googletag.pubads().setTargeting() per utilizzare il targeting a livello di pagina, come nell'esempio seguente.
<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>
In questo esempio sono definite due aree annuncio che specificano l'unità pubblicitaria/6355419/Travel/Asia e le dimensioni dell'annuncio 728x90. Successivamente, il targeting per chiave-valore viene applicato per limitare ulteriormente e differenziare gli annunci che possono essere pubblicati in ogni spazio.
Quando vengono utilizzati sia il targeting a livello di area annuncio sia quello a livello di pagina, le coppie chiave-valore vengono combinate e solo gli annunci che soddisfano tutti i criteri saranno idonei alla pubblicazione in una determinata area annuncio. In questo esempio, il targeting effettivo per ogni area è:
| Area annuncio | Targeting efficace |
|---|---|
| 1 | color=red AND position=atf AND interests=basketball |
| 2 | position=btf AND interests=basketball |
Scegli come target più chiavi o valori
Nell'esempio precedente è stata utilizzata una combinazione di targeting a livello di area annuncio e di pagina per definire più chiavi di targeting per una singola area annuncio. Ecco alcuni metodi alternativi per ottenere lo stesso targeting efficace:
Solo targeting a livello di slot
In questo esempio, le coppie chiave-valore condivise vengono ripetute per ogni area annuncio.
// 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');
Targeting predefinito a livello di pagina
In questo esempio, il targeting predefinito viene impostato a livello di pagina e sostituito a livello di slot, se necessario.
// 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());
È anche possibile scegliere come target più valori per una singola chiave fornendo un array di valori quando chiami setTargeting():
// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);
Targeting chiaro
Una volta impostato il targeting, le coppie chiave-valore configurate verranno inviate con ogni richiesta di annuncio per tutta la durata dell'area annuncio. In alcuni casi, tuttavia, potrebbe essere opportuno modificare il targeting nel tempo. Sebbene setTargeting() possa essere utilizzato per aggiungere e sovrascrivere le coppie chiave-valore, non è possibile rimuoverle in questo modo.
Per farlo, devi utilizzare Slot.clearTargeting() o
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();
Quando clearTargeting() viene chiamato con una chiave specifica (a livello di slot o di pagina), viene rimossa solo quella chiave. Se non viene specificata alcuna chiave, tutto il targeting a quel livello viene rimosso.
Nell'esempio precedente, il targeting effettivo per l'area annuncio dopo ogni passaggio è:
| Passaggio | Targeting efficace |
|---|---|
| 0 | color=red AND position=atf AND interests=basketball |
| 1 | position=atf AND interests=basketball |
| 2 | position=atf |