Les clés-valeurs peuvent être utilisées pour cibler les annonces plus précisément que les blocs d'annonces. En savoir plus sur les clés-valeurs
Pour chaque requête d'annonce, vous pouvez transmettre une ou plusieurs clés, chacune avec une ou plusieurs valeurs associées. Ces clés-valeurs seront évaluées par rapport aux options de ciblage configurées au niveau de l'élément de campagne dans Ad Manager. Par exemple, si vous transmettez une clé-valeur personnalisée age=18-34, les éléments de campagne ciblant la tranche d'âge 18-34 pourront être diffusés, à condition que tous les autres critères soient appliqués.
Définir le ciblage
Vous pouvez spécifier des clés-valeurs pour configurer le ciblage au niveau de l'espace et de la page, en fonction des besoins de votre réseau.
- Au niveau de l'emplacement
Vous permet de définir des clés-valeurs pour les espaces publicitaires individuels de votre page.
Le ciblage au niveau de l'espace publicitaire vous permet de configurer le ciblage par espace publicitaire. Cela est utile lorsque des espaces publicitaires individuels d'une même page nécessitent un ciblage différent, mais peut s'avérer inefficace lorsque les mêmes clés-valeurs sont appliquées à tous les espaces publicitaires. Utilisez Slot.setTargeting() pour utiliser le ciblage au niveau de l'emplacement, comme dans l'exemple suivant.
- Au niveau de la page
Vous permet de définir des clé-valeurs pour tous les espaces publicitaires de votre page.
Le ciblage au niveau de la page garantit que tous les espaces publicitaires disposent du même ensemble de clé-valeurs. Dans certains cas, cela peut réduire la quantité totale de code nécessaire pour configurer le ciblage. Utilisez googletag.pubads().setTargeting() pour utiliser le ciblage au niveau de la page, comme dans l'exemple suivant.
<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>
Dans cet exemple, deux espaces publicitaires sont définis, qui spécifient le bloc d'annonces /6355419/Travel/Asia et la taille d'annonce 728x90. Le ciblage par clé-valeur est ensuite appliqué pour restreindre et différencier davantage les annonces pouvant être diffusées dans chaque emplacement.
Lorsque le ciblage au niveau de l'espace publicitaire et de la page est utilisé, les clés-valeurs sont combinées et seules les annonces répondant à tous les critères peuvent être diffusées dans un espace publicitaire donné. Dans cet exemple, le ciblage effectif pour chaque emplacement est le suivant:
| Espace publicitaire | Ciblage efficace |
|---|---|
| 1 | color=red AND position=atf AND interests=basketball |
| 2 | position=btf AND interests=basketball |
Cibler plusieurs clés ou valeurs
Dans l'exemple précédent, une combinaison de ciblage au niveau de l'espace publicitaire et de la page a été utilisée pour définir plusieurs clés de ciblage pour un seul espace publicitaire. Voici d'autres approches pour obtenir le même ciblage efficace:
Ciblage au niveau de l'espace publicitaire uniquement
Dans cet exemple, les clés-valeurs partagées sont répétées pour chaque espace publicitaire.
// 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');
Ciblage par défaut au niveau de la page
Dans cet exemple, le ciblage par défaut est défini au niveau de la page et remplacé au niveau de l'emplacement si nécessaire.
// 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());
Vous pouvez également cibler plusieurs valeurs pour une seule clé en fournissant un tableau de valeurs lorsque vous appelez setTargeting():
// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);
Ciblage clair
Une fois le ciblage défini, les clé-valeurs configurées sont envoyées avec chaque demande d'annonce pendant toute la durée de vie de l'espace publicitaire. Toutefois, dans certains cas, il peut être souhaitable que le ciblage change au fil du temps. Bien que setTargeting() puisse être utilisé pour ajouter et écraser des clés-valeurs, il n'est pas possible de les supprimer de cette manière.
Pour ce faire, vous devez utiliser Slot.clearTargeting() ou googletag.pubads().clearTargeting() à la place.
// 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();
Lorsque clearTargeting() est appelé avec une clé spécifique (au niveau de l'emplacement ou de la page), seule cette clé est supprimée. Si aucune clé n'est spécifiée, tout ciblage à ce niveau est supprimé.
Dans l'exemple précédent, le ciblage effectif de l'espace publicitaire après chaque étape est le suivant:
| Étape | Ciblage efficace |
|---|---|
| 0 | color=red AND position=atf AND interests=basketball |
| 1 | position=atf AND interests=basketball |
| 2 | position=atf |