Segmentação por chave-valor

As chaves-valor podem ser usadas para segmentar anúncios de forma mais detalhada do que os 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 de acordo com as opções de segmentação configuradas no nível do item de linha no Ad Manager. Por exemplo, se você transmitir uma chave-valor personalizada de age=18-34, os itens de linha segmentados para a faixa etária de 18 a 34 anos vão estar qualificados para a veiculação, considerando todos os outros critérios.

Definir a segmentação

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

Nível do slot

Permite definir chaves-valor para espaços de anúncios individuais na sua página.

Com a segmentação no nível do slot, você pode configurar a segmentação por slot. Isso é útil nos casos em que espaços individuais na mesma página exigem segmentações diferentes, mas pode ser ineficiente em situações em que as mesmas chaves-valor são aplicadas a todos os espaços. Use Slot.setTargeting() para usar a segmentação no nível do slot, como no exemplo abaixo.

Nível da página

Permite definir chaves-valor em todos os espaços de anúncios da 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 usar a 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, dois espaços de anúncio são definidos, especificando o bloco de anúncios /6355419/Travel/Asia e o tamanho do anúncio 728x90. Em seguida, a segmentação por chave-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 é usada, as chaves-valor são combinadas e apenas os anúncios que atendem a todos os critérios são qualificados para veiculação em um determinado espaço. Neste exemplo, o direcionamento efetivo para cada slot é:

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 slot e da página foi usada para definir várias chaves de segmentação para um único espaço do anúncio. Confira algumas abordagens alternativas para alcançar a mesma segmentação eficaz:

Apenas segmentação no nível do slot

Neste exemplo, as chaves-valor compartilhadas são repetidas para cada espaço de 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, o direcionamento padrão é definido no nível da página e substituído 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 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 com cada solicitação de anúncio durante a vigência do local do anúncio. No entanto, em algumas circunstâncias, pode ser desejável que a segmentação mude ao longo do tempo. Embora setTargeting() possa ser usado para adicionar e substituir chaves-valor, não é possível removê-las dessa maneira. Para isso, use Slot.clearTargeting() ou 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();

Quando clearTargeting() é chamado com uma chave específica (no nível de slot ou de página), apenas essa chave é removida. Quando nenhuma chave é especificada, todo o direcionamento nesse nível é removido.

No exemplo anterior, a segmentação eficaz do espaço do 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`