Segmentação por chave-valor

As chaves-valor podem ser usadas para segmentar 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 um ou mais valores associados. Essas chaves-valor serão avaliadas em relação às opções de segmentação configuradas no nível do item de linha no Ad Manager. Por exemplo, se você informar uma chave-valor personalizada de age=18-34, os itens de linha segmentados para a faixa etária de 18 a 34 anos estarão qualificados para veiculação, desde que todos os outros critérios sejam correspondentes.

Definir segmentação

É possível especificar chaves-valor para configurar a segmentação no nível do espaço e da página com base nas necessidades da sua rede.

Nível do espaço

Permite que você defina 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 slots individuais na mesma página exigem segmentação diferente, mas pode ser ineficiente em situações em que as mesmas chaves-valor são aplicadas a todos os slots. Use Slot.setTargeting() para utilizar a segmentação no nível do slot, como no exemplo a seguir.

Nível da página

Permite que você defina chaves-valor em todos os espaços de anúncio na sua página.

A segmentação no nível da 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. Use googletag.pubads().settargeting() para utilizar a segmentação no nível da página, como no exemplo a seguir.

<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>

Neste exemplo, dois espaços de anúncio são definidos, especificando o bloco de anúncios /6355419/Travel/Asia e o tamanho de anúncio 728x90. Em seguida, a segmentação de chaves-valor é aplicada para restringir e diferenciar ainda mais os anúncios que podem ser veiculados em cada slot.

Quando a segmentação no nível do espaço e da página são usadas, as chaves-valor são combinadas, e somente os anúncios que atendem a todos os critérios são qualificados para serem veiculados em um determinado espaço. Neste exemplo, a marcação efetiva para cada slot é:

Espaço do anúncio Segmentação efetiva
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 do anúncio. Veja algumas abordagens alternativas para atingir 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 espaço 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 vários valores para uma única chave, fornecendo uma 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

Depois que a segmentação for definida, as chaves-valor configuradas serão enviadas a cada solicitação de anúncio durante a vida útil do espaço de anúncio. No entanto, em algumas circunstâncias, pode ser desejável que a segmentação mude com o tempo. Embora setTargeting() possa ser usada para adicionar e substituir chaves-valor, não é possível removê-las dessa forma. Para isso, é necessário usar Slot.cleartargeting() ou googletag.pubads().clear desejado().

// 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() é chamada com uma chave específica (no nível do slot ou da página), apenas essa chave é removida. Quando nenhuma chave é especificada, toda a segmentação nesse nível é removida.

No exemplo anterior, a segmentação efetiva para o espaço de anúncio após cada etapa é a seguinte:

Etapa Segmentação efetiva
0 color=red AND position=atf AND interests=basketball
1 position=atf AND interests=basketball
2 position=atf