Tags de passback

A biblioteca da Tag do editor do Google (GPT) permite gerar tags de anúncio com o recurso de passback. É possível usar essas tags para situações em que uma solicitação de anúncio enviada a terceiros deve ser preenchida por um anúncio programado na sua própria rede do Google Ad Manager.

Casos de uso

Programar itens de linha remanescentes ou substitutos

As tags de passback podem ser usadas quando um servidor de terceiros não tem anúncios para veicular ou quando um anúncio não atinge o CPM/preço mínimo combinado com o terceiro. Nesses casos, o servidor de terceiros veicula uma tag de passback da GPT, que retorna um anúncio interno ou outro anúncio remanescente da sua própria rede do Ad Manager.

Veicular anúncios no site de outro publisher

As tags de passback podem ser usadas para veicular anúncios da sua rede do Ad Manager no site de outro editor. Nesses casos, a tag de passback da GPT seria programada pelo outro editor e retornaria um anúncio da sua própria rede do Ad Manager.

Veicular anúncios em vídeo

Para criar passbacks de vídeo, use uma tag de vídeo padrão para transmitir dados de um terceiro ao Ad Manager.

É possível criar essa tag manualmente ou usando o gerador de tags de vídeo do Ad Manager.

Criar tags de passback

As tags de passback podem ser criadas usando a mesma API usada para criar tags de anúncio da GPT normais. No entanto, as tags de passback precisam ser renderizadas em um iframe para evitar que herdem configurações de nível de página de qualquer outra instância da GPT ativa no site do editor.

Uma tag de retorno de chamada de exemplo básico é mostrada na seção a seguir. Lembre-se de que esse fragmento deve ser renderizado dentro de um iframe. Para ver isso na prática, teste uma demonstração ao vivo deste exemplo no StackBlitz.

<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
<div id="gpt-passback">
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
        googletag.defineSlot('/6355419/Travel/Europe', [728, 90], 'gpt-passback')
          .addService(googletag.pubads());
        googletag.enableServices();
        googletag.display('gpt-passback');
    });
  </script>
</div>

Configurar tags de passback

As tags de passback são compatíveis com a variedade normal de recursos disponíveis para tags da GPT, como os abordados no guia de segmentação por chave-valor e nos exemplos de código. Os recursos exclusivos das tags de retorno ou que exigem configuração especial quando usados em um contexto de retorno são explicados nas seções a seguir.

Ativar o rastreamento de cliques

Para adicionar o rastreamento de cliques a uma tag de retorno, uma macro de URL de clique pode ser adicionada à tag, como no exemplo a seguir. O URL de clique será dinamicamente anexado ao URL de clique armazenado no servidor de anúncios do Ad Manager.

<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
<div id="gpt-passback">
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
        googletag.defineSlot('/6355419/Travel/Europe', [728, 90], 'gpt-passback')
          .addService(googletag.pubads())
          .setClickUrl('%%CLICK_URL_UNESC%%');
        googletag.enableServices();
        googletag.display('gpt-passback');
    });
  </script>
</div>

Herdar configurações de privacidade

Como as tags de devolução são renderizadas em um iframe, elas não herdam automaticamente as configurações de privacidade configuradas no nível da página. Quando os passbacks são usados para veicular um anúncio de um editor do Ad Manager para outro, a macro TFCD pode ser usada para incluir a configuração atual de tratamento para direcionamento a crianças no nível da página na solicitação de anúncio de passback.

<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
<div id="gpt-passback">
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
        googletag.defineSlot('/6355419/Travel/Europe', [728, 90], 'gpt-passback')
          .addService(googletag.pubads())
        googletag.pubads()
          .setPrivacySettings({childDirectedTreatment: Boolean('%%TFCD%%')});
        googletag.enableServices();
        googletag.display('gpt-passback');
    });
  </script>
</div>

Gerenciar o inventário do editor secundário

O Gerenciamento de múltiplos clientes (GMC) é um recurso do Ad Manager que concede acesso a solicitações de anúncios que outros publishers delegaram à sua conta. Para mais informações, consulte Sobre o Gerenciamento de múltiplos clientes.

Para usar o GMC, as tags de devolução do editor principal precisam ser atualizadas para incluir o código de rede do Ad Manager do editor secundário. Isso permite que o Ad Manager reconheça a rede do editor filho e ajuda a verificar se os criativos são veiculados corretamente.

<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
<div id="gpt-passback">
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
        googletag.defineSlot('/6355419,1234/Travel/Europe', [728, 90], 'gpt-passback')
          .addService(googletag.pubads())
        googletag.enableServices();
        googletag.display('gpt-passback');
    });
  </script>
</div>

No exemplo anterior, 6355419 é o código de rede do Ad Manager para o publisher principal, e 1234 é o código de rede para o publisher secundário.

Especificar o URL da página

Como as tags de passback são renderizadas em um iframe, a GPT talvez não consiga determinar o URL da página em que a tag está sendo veiculada. Se você usar o Ad Exchange ou o Google AdSense para preencher impressões de passback, esses sistemas não poderão enviar informações contextuais sobre a página aos compradores sem um URL. Isso pode reduzir os CPMs ou as taxas de preenchimento e, em alguns casos, levar a solicitações de anúncio recusadas.

Para evitar isso, a macro PATTERN pode ser usada para fornecer informações de URL da página a uma rede ou servidor de anúncios de terceiros. Essas informações podem ser adicionadas à tag de retorno como um atributo page_url.

<script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
<div id="gpt-passback">
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
        googletag.defineSlot('/6355419/Travel/Europe', [728, 90], 'gpt-passback')
          .addService(googletag.pubads());
        googletag.pubads().set('page_url', 'URL');
        googletag.enableServices();
        googletag.display('gpt-passback');
    });
  </script>
</div>