Los pares clave-valor se pueden usar para orientar los anuncios de manera más detallada que los bloques de anuncios. Obtenga más información sobre los pares clave-valor.
Para cada solicitud de anuncios, puede pasar una o más claves, cada una con uno o más valores asociados. Estos pares clave-valor se evaluarán según las opciones de orientación configuradas a nivel de la línea de pedido en Ad Manager. Por ejemplo, si pasa un par clave-valor personalizado de age=18-34, las líneas de pedido orientadas al rango de edad de 18 a 34 años podrán publicarse, siempre que se cumplan las demás condiciones.
Establecer orientación
Puedes especificar pares clave-valor para configurar la orientación a nivel de espacio publicitario y de página, según las necesidades de tu red.
- Nivel de ranura
Le permite establecer pares clave-valor para espacios publicitarios individuales de su página.
La orientación a nivel del espacio publicitario le permite configurar la orientación por espacio publicitario. Esto es útil en casos en los que las ranuras individuales de la misma página requieren orientación diferente, pero pueden ser ineficientes en situaciones en las que los mismos pares clave-valor se aplican a todas las ranuras. Usa Slot.setTargeting() para usar la orientación a nivel de espacio publicitario, como se indica en el siguiente ejemplo.
- Nivel de página
Le permite establecer pares clave-valor en todos los espacios publicitarios de su 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 para configurar la orientación. Usa googletag.pubads().setTargeting() para usar la orientación a nivel de página, como en el siguiente ejemplo.
<head>
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script>
window.googletag = window.googletag || {cmd: []};
// GPT slots
var adSlots = [];
googletag.cmd.push(function() {
// 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 el bloque de anuncios /6355419/Travel/Asia y el tamaño del anuncio 728x90. Luego, la orientación de pares clave-valor se aplica para restringir aún más y diferenciar los anuncios que se pueden publicar en cada espacio publicitario.
Cuando se usa la orientación a nivel de espacio publicitario y 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 determinado. En este ejemplo, el etiquetado efectivo para cada ranura 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 a varias claves o valores
En el ejemplo anterior, se usó una combinación de orientación a nivel de espacio publicitario y a nivel de la página a fin de definir varias claves de orientación para un solo espacio publicitario. Estos son algunos enfoques alternativos para lograr la misma orientación efectiva:
Solo orientació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');
Orientación predeterminada a nivel de la página
En este ejemplo, la orientación predeterminada se establece en el nivel de la página y se anula en el nivel del espacio publicitario 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 orientar varios valores para una sola clave, ya que proporciona un arreglo de valores cuando se llama a setTargeting():
// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);
Borrar orientación
Una vez que se establezca la orientació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 lograrlo, debes 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 de espacio publicitario o a nivel de la página), solo se quita esa clave. Cuando no se especifica ninguna clave, se quitan todas las orientaciones de ese nivel.
En el ejemplo anterior, la orientación efectiva del espacio publicitario después de cada paso es la siguiente:
| Paso | Orientación eficaz |
|---|---|
| 0 | color=red AND position=atf AND interests=basketball |
| 1 | position=atf AND interests=basketball |
| 2 | position=atf |