Macros para criativos personalizados

Saiba como usar macros com e sem escape

Conhecimento técnico

Este artigo é destinado a usuários que desenvolvem criativos personalizados e exigem conhecimento técnico.

Se você é um coordenador de publicidade que deve associar um criativo personalizado a um item de linha, mas não tem experiência técnica para resolver problemas de criativos personalizados, encontre um recurso que o faça. Isso pode ser uma pessoa na sua organização, que gerou o criativo personalizado no Ad Manager, ou um recurso em uma agência de anúncios que forneça o código usado no criativo personalizado.

As macros são usadas em criativos personalizados para diversas finalidades. Duas finalidades importantes são como marcadores para URLs de destino (clique) e URLs de rastreamento de cliques. Eles vêm em variedades sem escape, com escape e com escape duplo.

O escape é a prática de usar um caractere (ou uma série de caracteres) para representar outro caractere. Os URLs só podem ser transmitidos pela Internet por meio do conjunto de caracteres ASCII. No entanto, caracteres fora desse conjunto podem ser usados em URLs. Para isso, esses caracteres precisam ser codificados durante a transmissão para serem interpretados corretamente.

Ao desenvolver criativos personalizados, você precisa usar um ou mais dos itens a seguir no código do criativo:

  • URL de rastreamento de cliques sem escape: %%CLICK_URL_UNESC%%
  • URL de rastreamento de cliques com escape: %%CLICK_URL_ESC%%
  • URL de destino sem escape: %%DEST_URL%%
  • URL de destino com escape: %%DEST_URL_ESC%%
  • Macro de URL de destino com escape duplo: %%DEST_URL_ESC_ESC%%

Para garantir que os cliques sejam rastreados ou que os usuários cheguem ao URL de destino, você precisa usar a variante apropriada. Usar a variante errada pode significar que o rastreamento de cliques não é registrado ou que os usuários não alcançam o URL de destino. 

Se os URLs de cliques de rastreamento e os de cliques forem necessários, você também precisará garantir que as macros sejam sequenciadas ou "encadeadas" corretamente usando as variantes certas.

Neste artigo, você pode analisar exemplos corretos e incorretos de como usar macros de URL de destino e de rastreamento e como encadeá-las.

Exemplos de inserção de macro

Veja um exemplo de um URL de rastreamento de cliques sem escape do Campaign Manager 360. Os parâmetros foram removidos ou encurtados para maior clareza:

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=

Compare este URL com a versão com escape do mesmo URL:

http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253D

Aqui, os caracteres reservados tiveram escape duplo usando a codificação percentual. Por exemplo, pontos de interrogação (?) são sempre representados pela sequência de caracteres %253F, enquanto os sinais de igual (=) são sempre representados pela sequência de caracteres %253D.

Example 1A—Correto: rastreamento de cliques do Ad Manager em criativos personalizados

Neste exemplo, digamos que o clique no criativo personalizado deva levar ao seguinte URL:

http://www.google.com/page.html?param1=red&param2=blue

Um criativo de imagem pode rastrear cliques como o seguinte:

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Neste exemplo, o criativo renderizado no navegador do usuário seria:

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Esse é um URL de clique válido e correto porque o URL de clique do Ad Manager não tem escape, e o URL de destino tem escape adequado.

Example 1B—Incorreto: rastreamento de cliques do Ad Manager em criativos personalizados

Um erro comum que corromperia o código do criativo no exemplo acima seria usar a macro do URL de clique com escape. No código do criativo, isso ficaria assim:

<a href='%%CLICK_URL_ESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

O criativo renderizado no navegador do usuário seria:

<a href='http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Isso é incorreto. Como todos os parâmetros passaram por escape, o servidor adclick não consegue analisá-los de maneira adequada. O servidor interpretará isso como a solicitação de uma página chamada /aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue

Como essa página não existe, um erro HTTP 404 (Não encontrado) será retornado pelo servidor adclick, e o usuário não será direcionado para a página de destino do anúncio.

Example 1C— Incorreto: rastreamento de cliques do Ad Manager em criativos personalizados

Outro erro comum é usar a macro do URL de destino sem escape. No código do criativo, isso ficaria assim:

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_UNESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

O criativo renderizado no navegador do usuário seria:

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Esse exemplo específico poderia funcionar corretamente se o primeiro servidor de clique fosse inteligente o suficiente para interpretar os parâmetros restantes como URLs e fazer o escape. O Ad Manager reescreve o URL nesse caso, o que permite que o clique funcione corretamente. No entanto, não é seguro presumir que o servidor será capaz de lidar com URLs de clique formatados incorretamente. Recomendamos usar um URL de clique com a formatação certa, em vez de confiar que o Ad Manager ou o servidor de análise de terceiros conseguirá processar URLs incorretos.

Se o servidor não reescrever o URL que foi formatado incorretamente, este será interpretado da seguinte forma:

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue

Nesse caso, o último caractere '&' é interpretado como delimitador de um novo parâmetro para a PRIMEIRA solicitação do servidor em vez de um parâmetro que deve ser transmitido ao servidor que hospeda a página de destino do anúncio. Isso pode interferir no processamento do URL de clique pelo servidor de clique, o que pode evitar que o usuário seja redirecionado à página de destino. Mesmo que o usuário seja redirecionado, é provável que o segundo parâmetro (param2) não seja transmitido para a página de destino.

Exemplo 2A—Correto: rastreador de cliques de terceiros e macros

Os anunciantes podem pedir que você inclua um rastreador de cliques de terceiros para o criativo. Um rastreador mantém uma contagem independente de cliques para um criativo e auxilia a posterior auditoria ou reconciliação pelo anunciante.

Normalmente, o rastreador de cliques vem no formulário ou em um URL. Veja um exemplo do Campaign Manager 360:

http://ad.doubleclick.net/clk;a;b;c?[URL de clique][URL de destino]

O URL (ad.doubleclick.net) é uma referência ao servidor que registra a impressão ou o clique. Outros URLs de terceiros são semelhantes. O URL de clique deve ser representado por duas macros:

  • Macro de clique de escape: %%CLICK_URL_ESC%%
  • Macro de URL de destino com escape duplo: %%DEST_URL_ESC_ESC%%

Ambas representam o mesmo URL de clique e precisam ser incluídas após o ponto de interrogação (?). Veja um exemplo de um criativo de imagem com um URL de rastreamento de cliques do Campaign Manager 360:

<a href='http://ad.doubleclick.net/clk;a;b;c?%%CLICK_URL_ESC%%%%DEST_URL_ESC_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Ao usar um modelo de criativo, o rastreador de cliques de terceiros normalmente é representado dentro do código do criativo como um identificador de marcador de URL. O criativo renderizado no navegador do usuário expandirá as macros para o valor pretendido. Veja um exemplo:

<a href='http://ad.doubleclick.net/clk;a;b;c?http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/page.html%253Fparam1%253Dred%2526param2%253Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Visualização de criativos e macros de teste

O teste de criativos de anúncios garante que eles se comportem conforme o esperado. Como as macros são marcadores e às vezes há um código complexo envolvido, a melhor maneira de testar um criativo personalizado é visualizá-lo pelo item de linha. Para fazer isso, siga estas etapas:

  1. Abra o criativo em uma nova janela.

    O JavaScript não funciona na visualização disponível diretamente no Ad Manager. Além disso, as macros não podem ser visualizadas na versão expandida.

  2. Use as ferramentas para desenvolvedores do navegador para inspecionar elementos e o DOM.

Validar macros de rastreamento de cliques

Quando as macros são inseridas corretamente, clicar no criativo na visualização leva a uma página de destino do Ad Manager. Esta página confirma que o clique foi rastreado. Você é redirecionado para a página do URL de destino associada ao criativo.

Se uma dessas ações não acontecer, há um problema com as macros ou com o encadeamento delas. 

Validar macros de visualização

A validação de macros de rastreamento de impressões requer o uso de um analisador de tráfego. Um analisador de tráfego permite visualizar e capturar solicitações HTTP. Algumas ferramentas para desenvolvedores de navegadores incluem uma ferramenta desse tipo. Também há softwares de análise de tráfego de terceiros disponíveis.

Usando um analisador de tráfego, inspecione as solicitações HTTP quando o criativo do anúncio for carregado. Você está procurando uma solicitação bem-sucedida ou "ping" no servidor que registra a impressão. Observe os erros HTTP durante solicitações HTTP.

  • Se você não encontrar erros e conseguir ver um ping bem-sucedido do servidor que registra a impressão, as macros foram configuradas corretamente.
  • Se você encontrar algum erro, retorne ao código-fonte do criativo personalizado para resolver o problema. Um código de erro comum quando as macros são posicionadas incorretamente é HTTP 204.

Isso foi útil?

Como podemos melhorá-lo?
true
Pesquisa
Limpar pesquisa
Fechar pesquisa
Menu principal
11441303069733167878
true
Pesquisar na Central de Ajuda
true
true
true
true
true
148
false
false