Los pares clave-valor se pueden usar para segmentar los anuncios de manera más detallada que las unidades de anuncios. Más información sobre los pares clave-valor.
Para cada solicitud de anuncio, puede pasar una o más claves, cada una con una o más
valores asociados. Estos pares clave-valor se evaluarán frente a las opciones de segmentación.
a nivel de la línea de pedido en Ad Manager. Por ejemplo,
Pasa un par clave-valor personalizado de age=18-34, líneas de pedido orientadas al rango de edad.
Serán aptos para publicarse entre 18 y 34 años, siempre que los demás criterios coincidan.
Establecer segmentación
Puedes especificar pares clave-valor para configurar la segmentación tanto en a nivel de página en función de las necesidades de tu red.
- Nivel de ranura
Te permite establecer pares clave-valor para espacios publicitarios individuales en tu página.
La segmentación a nivel del espacio publicitario te permite configurar la segmentación por espacio. Esto es útil en los casos en que los espacios individuales de una misma página requieren una orientación diferente, pero puede resultar ineficiente en situaciones en las que la misma los pares clave-valor se aplican a todos los espacios. Usa Slot.setTargeting() para usar a nivel de espacio publicitario como en el siguiente ejemplo.
- Nivel de página
Te permite establecer pares clave-valor en todos los espacios publicitarios de tu página.
La orientación a nivel de la página garantiza que todos los espacios publicitarios tengan el mismo conjunto de pares clave-valor. En algunos casos, esto puede reducir la cantidad total de código necesario configurar la segmentación. Usa googletag.pubads().setTargeting() para utilizar la segmentación a nivel de la página, como en el siguiente ejemplo.
<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>
En este ejemplo, se definen dos espacios publicitarios que especifican la unidad
/6355419/Travel/Asia y el tamaño del anuncio es de 728x90. La segmentación de pares clave-valor
Se aplican para restringir y diferenciar aún más los anuncios que pueden publicarse en cada
ranura.
Cuando se usa la segmentación a nivel del espacio publicitario y de la página, los pares clave-valor se combinan y solo los anuncios que cumplan con todos los criterios serán aptos para publicarse en un espacio determinado. En este ejemplo, el etiquetado eficaz para cada horario disponible es el siguiente:
| Espacio publicitario | Orientación eficaz |
|---|---|
| 1 | color=red AND position=atf AND interests=basketball |
| 2 | position=btf AND interests=basketball |
Cómo orientar varias claves o valores
En el ejemplo anterior, se aplicó una combinación de segmentación a nivel del espacio publicitario y de la página para definir varias claves de segmentación para un solo espacio publicitario. Estos son algunos ejemplos enfoques alternativos para lograr la misma orientación efectiva:
Solo segmentación a nivel del espacio publicitario
En este ejemplo, los pares clave-valor compartidos se repiten para cada espacio publicitario.
// 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');
Segmentación predeterminada a nivel de la página
En este ejemplo, la orientación predeterminada se establece a nivel de la página y se anula a nivel de ranura según sea necesario.
// 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());
También es posible establecer como objetivo varios valores para una sola clave proporcionando un
array de valores cuando llamas a setTargeting():
// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);
Borrar segmentación
Una vez establecida la orientación, los pares clave-valor configurados se enviarán con cada
para toda la duración del espacio publicitario. Sin embargo, en algunas circunstancias, puede
sea conveniente que la orientación cambie con el tiempo. Si bien setTargeting() puede
para agregar y reemplazar pares clave-valor, no es posible quitarlos de esta manera.
Para lograrlo, Slot.clearTargeting() o
googletag.pubads().clearTargeting() debe tener las siguientes características:
en su lugar.
// 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();
Cuando se llama a clearTargeting() con una clave específica (ya sea en el
a nivel de la ranura o de la página), solo se quita esa clave. Si no se especifica ninguna clave,
la segmentación en ese nivel.
En el ejemplo anterior, la segmentación efectiva para el espacio publicitario después de cada el siguiente paso es:
| Paso | Orientación eficaz |
|---|---|
| 0 | color=red AND position=atf AND interests=basketball |
| 1 | position=atf AND interests=basketball |
| 2 | position=atf |