Le coppie chiave-valore possono essere utilizzate per indirizzare gli annunci in modo più granulare rispetto alle unità pubblicitarie. Scopri di più sulle coppie chiave-valore.
Per ogni richiesta di annuncio, puoi trasmettere una o più chiavi, ciascuna con una o più
e i 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 pari a age=18-34, gli elementi pubblicitari indirizzati alla fascia d'età
I segmenti di pubblico di età compresa tra 18 e 34 anni saranno idonei alla pubblicazione, a condizione che tutti gli altri criteri vengano soddisfatti.
Imposta targeting
Puoi specificare le coppie chiave-valore per configurare il targeting a livello di area annuncio a livello di pagina in base alle esigenze della tua rete.
- A livello di area annuncio
Consente di impostare coppie chiave-valore per singole aree annuncio nella pagina.
Il targeting a livello di area ti consente di configurare il targeting in base all'area annuncio. Ciò è utile nei casi in cui le singole aree sulla stessa pagina richiedano targeting diverso, ma può essere inefficiente in situazioni in cui le coppie chiave-valore siano applicate a tutte le aree annuncio. Utilizza le funzionalità di Slot.setTargeting() per utilizzare a livello di area annuncio come nell'esempio seguente.
- A livello di pagina
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 le coppie chiave-valore. In alcuni casi, ciò può ridurre la quantità totale di codice necessaria configurare il targeting. Utilizza le funzionalità di googletag.pubads().setTargeting() per utilizzare 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 dimensione dell'annuncio 728x90. Il targeting per coppia chiave-valore
applicate per limitare ulteriormente e differenziare gli annunci che possono essere pubblicati in ciascuno
slot machine.
Quando vengono utilizzati sia il targeting a livello di area annuncio che quello di pagina, le coppie chiave-valore vengono combinate e solo gli annunci che soddisfano tutti i criteri saranno idonei per la pubblicazione in una determinata area. In questo esempio, il tageting effettivo per ogni area è:
| Area annuncio | Targeting effettivo |
|---|---|
| 1 | color=red AND position=atf AND interests=basketball |
| 2 | position=btf AND interests=basketball |
Targeting di più chiavi o valori
Nell'esempio precedente, è stata utilizzata una combinazione di targeting a livello di area annuncio e di pagina utilizzate per definire più chiavi di targeting per una singola area annuncio. Ecco alcuni esempi approcci alternativi per ottenere lo stesso targeting efficace:
Solo targeting a livello di area annuncio
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 viene sostituito a livello di area annuncio, 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 durante la chiamata a setTargeting():
// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);
Cancella targeting
Una volta impostato il targeting, le coppie chiave-valore configurate verranno inviate con ogni
richiesta di annuncio per l'intera durata dell'area annuncio. In alcune circostanze, tuttavia, potrebbe
desiderare che il targeting cambi nel tempo. Sebbene setTargeting() possa essere
utilizzate per aggiungere e sovrascrivere le coppie chiave-valore, non è possibile rimuoverle in questo modo.
A questo scopo, Slot.clearTargeting() oppure
googletag.pubads().clearTargeting() deve essere
al suo posto.
// 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
a livello di area annuncio o di pagina), viene rimossa solo quella chiave. Se non viene specificata alcuna chiave,
il targeting a quel livello viene rimosso.
Nell'esempio precedente, il targeting effettivo per l'area annuncio dopo ogni è:
| Passaggio | Targeting effettivo |
|---|---|
| 0 | color=red AND position=atf AND interests=basketball |
| 1 | position=atf AND interests=basketball |
| 2 | position=atf |