As chaves-valor podem ser usadas para segmentar os anúncios de maneira mais granular do que blocos de anúncios. Saiba mais sobre chaves-valor.
Para cada solicitação de anúncio, é possível transmitir uma ou mais chaves, cada uma com uma ou mais chaves
valores associados. Essas chaves-valor serão avaliadas em relação às opções de segmentação
configurados no nível do item de linha no Ad Manager. Por exemplo, se
você transmite uma chave-valor personalizada de age=18-34, itens de linha segmentados para a faixa etária.
18 a 34 anos estarão qualificados para veiculação, desde que todos os outros critérios sejam correspondentes.
Definir segmentação
Você pode especificar chaves-valor para configurar a segmentação no nível do espaço de acordo com as necessidades da rede.
- Nível do slot
Permite definir chaves-valor para espaços de anúncio individuais na sua página.
A segmentação no nível do espaço permite que você configure a segmentação por espaço. Isso é útil nos casos em que espaços individuais na mesma página exigem segmentação diferente, mas pode ser ineficiente em situações em que a mesma serão aplicadas a todos os espaços. Usar Slot.setTargeting() para utilizar o nível do espaço do anúncio. segmentação, como no exemplo a seguir.
- Nível da página
Permite definir chaves-valor em todos os espaços de anúncio na sua página.
A segmentação em nível de página garante que todos os espaços de anúncio tenham o mesmo conjunto de chaves-valor. Em alguns casos, isso pode reduzir a quantidade total de código necessária para configurar a segmentação. Usar googletag.pubads().setTargeting() para utilizar segmentação no nível da página, como no exemplo a seguir.
<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>
Neste exemplo, são definidos dois espaços de anúncio que especificam o bloco de anúncios
/6355419/Travel/Asia e o tamanho de anúncio 728x90. Então, a segmentação de chave-valor
aplicados para restringir e diferenciar ainda mais os anúncios que podem ser veiculados em cada
espaço.
Quando a segmentação no nível do espaço e da página são usadas, os valores-chave são combinados e somente os anúncios que atendem a todos os critérios estarão qualificados para veiculação em um determinado espaço. Neste exemplo, a tag efetiva para cada espaço é:
| Espaço do anúncio | Segmentação eficaz |
|---|---|
| 1 | color=red AND position=atf AND interests=basketball |
| 2 | position=btf AND interests=basketball |
Segmentar várias chaves ou valores
No exemplo anterior, uma combinação de segmentação no nível do espaço e da página foi usada para definir várias chaves de segmentação para um único espaço de anúncio. Confira alguns abordagens alternativas para alcançar a mesma segmentação eficaz:
Somente segmentação no nível do espaço
Neste exemplo, as chaves-valor compartilhadas são repetidas para cada espaço do anúncio.
// 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');
Segmentação padrão no nível da página
Neste exemplo, a segmentação padrão é definida no nível da página e substituída no nível do slot, conforme necessário.
// 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());
Também é possível segmentar diversos valores para uma única chave fornecendo um
matriz de valores ao chamar setTargeting():
// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);
Limpar segmentação
Após definir a segmentação, as chaves-valor configuradas serão enviadas com cada
solicitação de anúncio para a vida útil do espaço de anúncio. Em algumas circunstâncias, no entanto, pode
que a segmentação mude ao longo do tempo. Embora setTargeting() possa ser
usada para adicionar e substituir chaves-valor, não será possível removê-las desta forma.
Para isso, Slot.clearTargeting() ou
googletag.pubads().clearTargeting() precisa ser
é usado no lugar dele.
// 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() é chamado com uma chave específica (no
nível do espaço ou da página), só essa chave é removida. Quando nenhuma chave é especificada,
segmentação nesse nível é removida.
No exemplo anterior, a segmentação efetiva do espaço de anúncio após cada etapa é:
| Etapa | Segmentação eficaz |
|---|---|
| 0 | color=red AND position=atf AND interests=basketball |
| 1 | position=atf AND interests=basketball |
| 2 | position=atf |