Los pares clave-valor se pueden usar para segmentar anuncios de un modo más detallado que las unidades de anuncios. Obtén más información sobre los pares clave-valor.
Para cada solicitud de anuncio, puedes pasar una o más claves, cada una con uno o más valores asociados. Estos pares clave-valor se evaluarán en función de las opciones de segmentación configuradas a nivel de la línea de pedido en Ad Manager. Por ejemplo, si pasas un par clave-valor personalizado de age=18-34, las líneas de pedido segmentadas para el rango de edad de 18 a 34 años serán aptas para publicarse, siempre que se cumplan los demás criterios de coincidencia.
Cómo establecer la segmentación
Puedes especificar pares clave-valor para configurar la segmentación a nivel del espacio publicitario y de la página según las necesidades de tu red.
- A nivel de la 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 publicitario. Esto es útil en los casos en que los espacios individuales de la misma página requieren una segmentación diferente, pero puede ser ineficiente en situaciones en las que se aplican los mismos pares clave-valor a todos los espacios. Usa Slot.setTargeting() para utilizar la segmentación a nivel del slot, como se muestra en el siguiente ejemplo.
- Nivel de página
Te permite establecer pares clave-valor en todos los espacios publicitarios de tu página.
La segmentació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 para 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 de anuncios /6355419/Travel/Asia y el tamaño del anuncio 728x90. Luego, se aplica la segmentación por par clave-valor para restringir y diferenciar aún más los anuncios que se pueden publicar en cada posición.
Cuando se utilizan la segmentación a nivel del espacio publicitario y la segmentación a nivel de la página, se combinan los pares clave-valor y solo los anuncios que cumplan con todos los criterios serán aptos para publicarse en un espacio publicitario determinado. En este ejemplo, la segmentación efectiva para cada segmento es la siguiente:
| Espacio publicitario | Segmentación eficaz |
|---|---|
| 1 | color=red AND position=atf AND interests=basketball |
| 2 | position=btf AND interests=basketball |
Segmenta para varios valores o claves
En el ejemplo anterior, se usó una combinación de segmentación a nivel del espacio y de la página para definir varias claves de segmentación para un solo espacio publicitario. A continuación, se muestran algunos enfoques alternativos para lograr la misma segmentación eficaz:
Solo segmentación a nivel de la posición
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 segmentación predeterminada se establece a nivel de la página y se anula a nivel del espacio 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 segmentar varios valores para una sola clave proporcionando un array de valores cuando llames a setTargeting():
// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);
Cómo borrar la segmentación
Una vez que se haya establecido la segmentación, los pares clave-valor configurados se enviarán con cada solicitud de anuncio durante la vida útil del espacio publicitario. Sin embargo, en algunas circunstancias, puede ser conveniente que la segmentación cambie con el tiempo. Si bien setTargeting() se puede usar para agregar y reemplazar pares clave-valor, no es posible quitarlos de esta manera.
Para ello, se debe usar 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();
Cuando se llama a clearTargeting() con una clave específica (ya sea a nivel del espacio o de la página), solo se quita esa clave. Cuando no se especifica ninguna clave, se quita todo el segmentación en ese nivel.
En el ejemplo anterior, la segmentación efectiva para el espacio publicitario después de cada paso es la siguiente:
| Paso | Segmentación eficaz |
|---|---|
| 0 | color=red AND position=atf AND interests=basketball |
| 1 | position=atf AND interests=basketball |
| 2 | position=atf |