Anúncios de newsletter (Beta)

Os anúncios de newsletter podem ser usados para mostrar anúncios de reserva e programática garantida do Google Ad Manager em newsletters por e-mail. Este guia descreve como implementar anúncios em newsletters por e-mail.

Visão geral

Confira o fluxo de trabalho geral para implementar um anúncio de newsletter:

  1. Crie ou selecione um bloco de anúncios do Ad Manager.
  2. Crie ou selecione um item de linha do Ad Manager. Lembre-se das seguintes diretrizes:
    • Os criativos esperados precisam conter todos os tamanhos dos criativos de anúncios que você pretende exibir nas newsletters.
    • A segmentação precisa incluir o bloco de anúncios da etapa 1.
    • Somente criativos de imagem são aceitos para anúncios de newsletter.
  3. (Recomendado) Configure um item de linha interno para servir como backup, caso um anúncio não seja preenchido.
  4. Crie uma tag de anúncio de newsletter.
  5. Insira a tag de newsletter no local em que você quer que o anúncio apareça na newsletter.

Formato da tag de anúncio de newsletter

Uma tag de anúncio de boletim informativo consiste em um elemento de imagem HTML (img) aninhado em um elemento âncora HTML (a). Cada tag de anúncio de newsletter precisa ser seguida por um link "Sobre este anúncio" para fornecer informações aos usuários sobre o anúncio exibido.

<!-- Newsletter ad tag -->
<a href="JUMP_URL?AD_PARAMETERS" target="_blank">
  <img src="AD_URL?AD_PARAMETERS">
</a>

<!-- "About this ad" link -->
<a href="JUMP_URL?AD_PARAMETERS&click_type=wta">About this ad</a>

Os formatos dos URLs de âncora href e de imagem src são os seguintes:

JUMP_URL https://securepubads.g.doubleclick.net/gampad/jump
AD_URL https://securepubads.g.doubleclick.net/gampad/ad
AD_PARAMETERS ptt=21&iu=AD_UNIT_PATH&sz=CREATIVE_SIZES&clkk=CLKK_VALUE&clkp=CLKP_VALUE&url=URL&t=TARGETING_KEY_VALUES

Consulte a seção de exemplos para conferir um exemplo completo de tag de anúncio de newsletter usando valores simulados.

Confira uma explicação detalhada dos parâmetros de anúncio de newsletter compatíveis:

Parâmetros
ptt

Precisa ser sempre definido como 21 para indicar que esta é uma solicitação de anúncio de newsletter.

Obrigatório Sim
iu

Um caminho do bloco de anúncios, que identifica o bloco de anúncios do Ad Manager a ser mostrado.

Os caminhos dos blocos de anúncios precisam ter o seguinte formato:

/network-code/[parent-ad-unit-code/.../]ad-unit-code

  • network-code é um identificador exclusivo da rede do Ad Manager à qual o bloco de anúncios pertence. Ao usar o Gerenciamento de múltiplos clientes (GMC), os identificadores de rede pai e filho precisam ser fornecidos como parent,child.
  • parent-ad-unit-code são os códigos de todos os blocos de anúncios pai, que se aplicam apenas a blocos de anúncios que não são de nível superior.
  • ad-unit-code é o código do bloco de anúncios que vai ser exibido.
Todos os códigos de bloco de anúncios incluídos no caminho do bloco de anúncios precisam obedecer às regras de formatação especificadas pelo Ad Manager.

Exemplo Bloco de anúncios de nível superior: /123/homepage
Bloco de anúncios de vários níveis: /123/sports/baseball
MCM: /123,456/homepage
Obrigatório Sim
sz

Os tamanhos dos criativos de anúncios qualificados para exibição nesse espaço de anúncio.

Verifique se os tamanhos listados aqui correspondem aos selecionados no campo Criativos esperados do item de linha selecionado.

Vários tamanhos podem ser especificados, separados por um caractere de barra vertical (|). O valor completo desse parâmetro precisa ser codificado para uso em URLs.

Exemplo Tamanhos: 216 x 36, 300 x 50 ou 320 x 50
String de tamanho: 216x36|300x50|320x50
Valor do parâmetro: 216x36%7c300x50%7c320x50
Obrigatório Sim
clkk

Uma string exclusiva por destinatário e por campanha de e-mail.

Cada anúncio de newsletter incluído no seu e-mail precisa especificar um valor clkk exclusivo. No entanto, cada tag de anúncio de newsletter precisa especificar o mesmo valor de clkk nos URLs de âncora href e de imagem src.

Para gerar o valor de clkk, use o recurso de tag de mesclagem fornecido pelo seu provedor de serviços de e-mail (ESP). As "tags de mesclagem" são variáveis dinâmicas e personalizáveis em e-mails, como *|DATE:d/m/y|*. O nome exato do recurso de tag de fusão varia de acordo com o ESP.

O valor clkk é, em resumo, uma concatenação de várias variáveis de tags de mesclagem e tem a seguinte aparência: *|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*. As variáveis e a sintaxe disponíveis são dependentes do ESP. Portanto, o valor clkk pode não seguir exatamente esse formato.

Para gerar um valor clkk:

  1. Localize a documentação do ESP sobre "tags de mala direta".
  2. Determine a combinação de variáveis de tag de mesclagem que, quando concatenadas, produzem uma string exclusiva por usuário e por campanha de e-mail.
  3. Concatenar essas variáveis para formar o valor clkk.

Obrigatório Sim
clkp

Uma string que identifica exclusivamente um único posicionamento de anúncio de newsletter.

Esse parâmetro é obrigatório quando vários anúncios de newsletter são incluídos em um e-mail. Se a sua newsletter tiver apenas um único posicionamento de anúncio, esse parâmetro poderá ser omitido.

Exemplo 1, 2, top, middle, bottom
Obrigatório Sim, quando há várias posições de anúncio
url

O URL "ver no navegador" da newsletter atual.

O valor de url precisa ser preenchido pela tag de mesclagem do URL "visualização no navegador" fornecida pelo seu provedor de serviços de e-mail (ESP). As "tags de mesclagem" são variáveis dinâmicas e personalizáveis em e-mails, como *|ARCHIVE|*. O nome exato da tag de mala direta de URL "visualização no navegador" varia de acordo com o ESP.

Obrigatório Sim
t

Segmentação por chaves-valor.

As chaves e os valores são separados por um caractere de igualdade (=), e vários pares de chave-valor são separados por um caractere de "e" comercial (&). Cada chave e valor, assim como a string de segmentação completa, precisa ser codificada para URL.

As restrições atuais para chaves-valor se aplicam aos anúncios de newsletter. Consulte Começar a usar chaves-valor para mais detalhes.

Exemplo
Chave Valor
genre comedy
movie Lilo & Stitch
String de segmentação: genre=comedy&movie=Lilo%20%26%20Stitch
Valor do parâmetro: genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch
Obrigatório Não

Exemplo

Confira um exemplo de como seria uma tag de anúncio de newsletter completa para um conjunto de valores simulados.

Caminho do bloco de anúncios (iu) /1/example_ad_unit
Tamanhos de criativos (sz) 216x36|300x50|320x50
String exclusiva por e-mail (clkk) *|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*
Posição do anúncio (clkp) top
Segmentação (t) genre=comedy&movie=Lilo & Stitch
URL de visualização no navegador (url) *|ARCHIVE|*
<!-- Newsletter ad tag -->
<a
  href="https://securepubads.g.doubleclick.net/gampad/jump?ptt=21&iu=/1/example_ad_unit&sz=216x36%7c300x50%7c320x50&clkk=*|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*&clkp=top&url=*|ARCHIVE|*&t=genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch"
  target="_blank">
  <img
    src="https://securepubads.g.doubleclick.net/gampad/ad?ptt=21&iu=/1/example_ad_unit&sz=216x36%7c300x50%7c320x50&clkk=*|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*&clkp=top&url=*|ARCHIVE|*&t=genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch">
</a>

<!-- "About this ad" link -->
<a
  href="https://securepubads.g.doubleclick.net/gampad/jump?ptt=21&iu=/1/example_ad_unit&sz=216x36%7c300x50%7c320x50&clkk=*|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*&clkp=top&url=*|ARCHIVE|*&t=genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch&click_type=wta">
  About this ad
</a>

Perguntas frequentes

Como gerar um valor clkk válido?

Consulte a referência de parâmetro clkk.

Qual combinação de variáveis de tag mesclada devo usar para formar o valor clkk?

Como as variáveis de tag de mesclagem disponíveis e a sintaxe adequada variam de acordo com o provedor de serviços de e-mail (ESP), não podemos aconselhar nem verificar seus valores de clkk. Consulte a documentação do ESP para identificar uma combinação de variáveis que vai gerar uma string exclusiva por usuário e por campanha de e-mail.

Confira a documentação de alguns ESPs usados com frequência:

Como saber se o valor de clkk está correto?

Quando o valor de clkk está correto, ele gera uma string exclusiva por usuário e por campanha de e-mail. Para verificar isso, gere e-mails de teste, clique nos anúncios neles, verifique se você é direcionado ao URL de destino correto e se os cliques estão sendo informados no Google Ad Manager.

Se ainda não fez isso, recomendamos que você analise a referência da tag de anúncio de newsletter para saber mais sobre como gerar valores clkk corretos. Confira alguns requisitos importantes:

  • A combinação de "tags de mesclagem" que compõem um valor clkk precisa ser exclusiva por usuário e por campanha de e-mail. Se o valor de clkk tiver apenas uma variável (por exemplo, clkk=%UMF_MD5), provavelmente não será exclusivo o suficiente.
  • Um posicionamento de anúncio individual precisa especificar o mesmo valor de clkk nos URLs de âncora href e de imagem src. Se o href e o src de um determinado anúncio de newsletter não tiverem o mesmo valor de clkk, o anúncio não será veiculado corretamente e poderá apresentar comportamentos inesperados.

Por que os anúncios não aparecem nos meus boletins informativos?

Confira alguns problemas comuns que podem causar falhas na inserção de anúncios na newsletter:

  • A tag de anúncio da newsletter está incorreta.
    • Os parâmetros de âncora HTML href e de imagem src não correspondem.
    • O URL do anúncio não inclui o parâmetro ptt=21.
    • A tag contém espaços vazios.
    • Há erros de digitação ou parâmetros não concatenados com um "e" comercial (&).
    • As tags de mesclagem apresentam caracteres inválidos quando renderizados pelo ESP.
    • Contém PII, como endereço de e-mail ou número do cartão de crédito.
  • O caminho do bloco de anúncios está incorreto.
  • O item de linha não está ativo.

Por que os usuários acessam uma página incorreta depois de clicar em um anúncio?

Isso provavelmente se deve a um valor clkk que não é exclusivo. Consulte a referência do parâmetro clkk para mais detalhes.

Por que os cliques não estão sendo informados nos relatórios do Ad Manager?

Há dois possíveis motivos:

  1. O recurso de acompanhamento de cliques do seu ESP foi ativado, o que afeta a capacidade do Google de registrar cliques.
  2. O valor de clkk está incorreto. Consulte a referência do parâmetro clkk para mais detalhes.

Como saber se o recurso de rastreamento de cliques do meu ESP está ativado?

Consulte a documentação do ESP ou entre em contato com o suporte ao cliente para mais informações.

Como posso mostrar diferentes tamanhos de criativos dependendo do tipo de dispositivo ou tamanho da tela?

Você pode usar consultas @media CSS para redimensionar dinamicamente criativos com base no tamanho da janela de visualização do navegador. No exemplo abaixo, quando a largura da janela de visualização é de no máximo 480 pixels, o elemento img do anúncio (identificado por class="ad) ocupa 100% da largura do contêiner pai. Quando a largura da janela de visualização é de pelo menos 480 pixels, ele ocupa apenas 50% da largura do contêiner pai. A proporção do anúncio permanece a mesma em ambos os casos, desde que nenhum outro tamanho seja especificado para o elemento img do HTML.

<html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
    <meta name="viewport" content="width=device-width,initial-scale=1" />
    <style>
      @media only screen and (max-width: 480px) {
        .ad {
          width: 100%;
        }
      }
      @media only screen and (min-width: 480px) {
        .ad {
          width: 50%;
        }
      }
    </style>
  </head>
  <body></body>
</html>