Macros do Campaign Manager 360

Introdução às macros

O que são macros do Campaign Manager 360?

As macros do Campaign Manager 360 são comandos curtos que o servidor de anúncios do Campaign Manager 360 expande em valores correspondentes, como palavras-chave, nomes-chave de sites ou URLs. Algumas macros ajudam a registrar informações para a emissão de relatórios, enquanto outras determinam qual anúncio é veiculado ou para onde o anúncio redireciona os usuários depois de um clique. A maioria das macros tem somente alguns caracteres, o que facilita a inserção em tags.

É possível inserir as macros do Campaign Manager 360 em diversos contextos, incluindo um URL da página de destino, uma tag do rastreador de cliques, um URL de redirecionamento, o HTML de um criativo, um cabeçalho de frame ou uma tag do Floodlight. A macro poderá se expandir quando o anúncio for veiculado. Também poderá ser expandida depois de outros eventos, como uma chamada do Floodlight. Ela também poderá se expandir dinamicamente (com informações específicas do usuário). Isso dependerá da macro utilizada e do lugar em que ela será inserida.

Nem todas as macros funcionam em todos os contextos. Se você inserir uma macro em uma fonte não compatível, o servidor de anúncios do Campaign Manager 360 poderá não expandir a macro corretamente. Use a tabela abaixo para relacionar as macros com as fontes corretas. Por exemplo, os servidores de anúncios do Campaign Manager 360 expandirão a macro %g se você a inserir nos URLs das páginas de destino. No entanto, eles não expandirão essa macro se você a inserir em uma tag de rastreador de cliques.

Informações gerais

• As macros do Campaign Manager 360 diferenciam maiúsculas de minúsculas. Sempre digite as macros em minúsculas. Por exemplo, %c é uma macro válida, mas %C não.

• Você pode usar separadores entre macros, mas não é necessário. Se você usar separadores, use uma vírgula (,) ou uma barra vertical (|). A menos que você seja um coordenador de publicidade experiente, evite usar outros separadores, já que alguns deles poderão causar problemas se usados no contexto incorreto.

• Para editar macros nos URLs de rastreamento de fornecedores, use as tags de evento. Este é o processo básico:

  • Primeiro, crie uma tag de evento no Campaign Manager 360. Em seguida, adicione o URL de rastreamento do fornecedor à tag de evento. Pode ser um URL de rastreamento de cliques, um pixel de impressão ou um URL de pesquisa. Você pode adicionar ou remover facilmente macros do seu URL de rastreamento nas propriedades da tag de evento no Campaign Manager 360.

  • Quando sua tag de evento estiver pronta, você poderá aplicá-la aos anúncios. Seus anúncios usarão o URL de rastreamento na sua tag de evento quando estiverem em veiculação. O Campaign Manager 360 facilita a aplicação da sua tag de evento em vários anúncios de uma só vez. Por exemplo, é possível definir sua tag de evento para ser automaticamente aplicada a todos os anúncios da sua campanha. Para começar, siga as etapas no guia de tag de evento.

• A única versão da macro de expansão que funciona em tags do Floodlight é %ers!. Saiba mais

Tipos de macro

%c – macro de string de clique

A macro %c se expande na string de clique do Campaign Manager 360 no URL da página de destino do criativo. Uma string de clique é parte de um URL da página de destino que direciona seu navegador para os servidores de anúncios do Campaign Manager 360.

Use %c_esc em vez de %c se você precisar usar uma versão de escape da string de clique em um criativo personalizado. As strings de cliques do Campaign Manager 360 usam o "e" comercial (&), o que poderá causar problemas se você trabalhar com servidores de terceiros.

A macro %c não se expandirá para incluir tags de evento de clique em criativos de exibição personalizada.

Como as strings de clique funcionam: quando um usuário clica em um criativo, o navegador é direcionado ao URL da página de destino. A click string redireciona o navegador para os servidores de anúncios do Campaign Manager 360 antes de enviá-lo para a página de destino do anunciante. O Campaign Manager 360 adiciona automaticamente a click string ao seu URL de clique no momento de cada impressão.

Se você adicionar manualmente um URL da página de destino ao HTML de um criativo personalizado, talvez seja necessário adicionar a macro %c para garantir que os cliques redirecionem aos servidores de anúncios do Campaign Manager 360. Adicione %u (a macro da página de destino) se você quiser expandir a click string e o URL da página de destino. %c%u se expande para um URL completo da página de destino.

Etapas para implementação. Aqui está um exemplo de click string:

Para adicionar uma string de clique ao URL de clique de um criativo personalizado, posicione a macro %c no início do URL da página de destino no código do criativo, como neste URL de clique:

Quando um servidor de anúncios veicula um criativo, a macro %c se expande e forma a click string. Veja um exemplo da aparência do URL da página de destino acima depois que a macro %c no início se expande:

Você pode ver que %c se expandiu na string de clique no início do URL da página de destino, formando um URL de criativo completo.

Para inserir todo o URL do criativo de uma só vez, combine a macro %c (string de clique) com a macro %u (URL da página de destino): <a href="%c%u">. As duas macros se expandem formando o URL do criativo completo.

Por exemplo, se você inserir <a href="%c%u"> no código HTML, a macro poderá se expandir para:

Quando %u se expande para um URL da página de destino, as outras macros no URL da página de destino também se expandem automaticamente, incluindo a macro %c.

%e — macro de expansão

A macro %e se expande e forma o número de códigos de diversas propriedades de um criativo. Insira um assistente de acesso depois da macro para determinar que número do código a macro formará ao se expandir e qual propriedade do criativo será rastreada. Veja abaixo a lista de assistentes de acesso.

É possível usar as tabelas de correspondência para definir esses números do código e associá-los às propriedades de criativos, já que os números do código são vinculados às descrições no Campaign Manager 360 e no seu próprio banco de dados de back-end. Esses números de código podem ajudar você a rastrear diferentes propriedades dos criativos por meio dos servidores de anúncios do Campaign Manager 360.

As tags do Floodlight são compatíveis com somente uma versão da macro de expansão: %ers!. Elas não aceitam outros tipos de macro %e. %ers! funciona em todos os lugares em que a macro de expansão for compatível (veja a tabela acima).

Se você usar anúncios de rastreamento em inventário do app para dispositivos móveis e usar uma página de destino estática, a macro %e não será expandida corretamente.

Não há limite para o número de macros %e que um URL da página de destino pode conter. Veja um exemplo de URL da página de destino com três macros %e:

%g — macro de dados geográficos

A macro %g fornece informações geográficas correspondentes à solicitação do anúncio. Ela pode ser usada para refletir dinamicamente a localização de usuários em criativos padrão, personalizados e rich media. A macro %g se expande com uma string de valores-chave para informações como abreviação de país, abreviação de estado, cidade, código postal, região de Área designada do mercado^® e largura de banda da conexão com a Internet. Essas informações voltam para você por meio dos servidores de anúncios do Campaign Manager 360.

Por exemplo, %g pode expandir-se da seguinte forma para um usuário na cidade de Nova York:

%h — macro do servidor de criativos

A macro %h se expande para formar o nome do host do servidor que veicula o criativo. Isso elimina a necessidade de codificar o nome do host na tag. O nome do host varia, e a macro se expande dinamicamente para cada criativo.

Adicione a macro %h ao início do URL na tag, como nesta tag de imagem, em que "123456" é um marcador de posição para o ID do anunciante:

%i — macro de impressão

A macro %i se expande para uma string de impressão, que permite ao servidor de anúncios do Campaign Manager 360 rastrear as impressões de um anúncio intersticial no momento da impressão.

Adicione a macro %i no começo do URL na tag, como neste exemplo:

A macro %i precisa ser usada em todos os anúncios intersticiais, porque permite que o servidor de anúncios do Campaign Manager 360 controle quando uma impressão intersticial for realmente veiculada.

%k — macro de palavra-chave

A macro %k se expande e forma uma substring encontrada nas tags de anúncio (principalmente no URL solicitado). É possível usar essa macro para exibir palavras-chave digitadas pelo usuário nos criativos.

Essa macro também é útil para a compra de diversas palavras-chave: ela se expande e pode formar diversas palavras-chave para o mesmo criativo, dependendo de qual palavra-chave o usuário inserir. Por exemplo, considere como a macro %k ajuda um anunciante com a compra de uma palavra-chave para termos como car insurance e car loans. Quando um usuário pesquisar por car insurance, o criativo com essa macro exibirá Clique aqui para seguro de automóveis. Quando um usuário pesquisar por car loans, o mesmo criativo exibirá Clique aqui para financiamentos de automóveis.

Use um par de valores-chave para designar qual substring a macro formará ao se expandir. Um par de valores-chave consiste em uma chave (start_key_string) e um valor correspondente (end_character).

Insira sua macro e o par de valores-chave na seguinte ordem: a macro, o primeiro valor, um ponto de exclamação (!) e, finalmente, o segundo valor. O formato é semelhante a este:

A macro %k captura uma substring designada por esses parâmetros. Ela encontra a palavra-chave que você designa e expande a macro nela. Insira o par de valores-chave em uma tag ad do Campaign Manager 360 ou uma tag jump do Campaign Manager 360.

Outro uso da macro %k é decodificar os caracteres codificados. Quando a macro passa uma substring ao HTML de um criativo, todos os caracteres com escape na substring capturada são convertidos automaticamente de volta nos seus conjuntos de caracteres originais. Exemplo:

Para exibir car insurance no criativo, decodifique o caractere de escape +. Assim, o anunciante fará a incorporação de %k no código do criativo. O servidor de anúncios captura a substring kw=car+insurance, decodifica o caractere + e o exibe como seguro de automóveis no criativo.

Agora o código estará assim:

Uma observação sobre as macros %k e %p: as duas macros são similares na forma como capturam uma substring designada por start_key_string, mas elas se diferem na forma como passam a substring. Enquanto a macro %k passa a substring ao HTML do criativo, a macro %p passa a substring ao URL. Ao contrário da macro %p, a macro%k só funciona no código HTML de um criativo.

%m — macro de código de correspondência

A macro %m se expande para o valor do cookie da DoubleClick de um usuário nos casos em que as configurações do navegador disponibilizam cookies quando o usuário clica no criativo. Essa macro também é usada para gerar uma lista de IDs de usuário e, em seguida, segmentar novamente os usuários que já responderam ao criativo. O ID do usuário é criptografado com a chave de criptografia do código do anunciante. Saiba mais sobre a criptografia do ID do usuário em sua conta do Campaign Manager 360.

Você pode inserir a macro no URL da página de destino, URL de redirecionamento, código do criativo ou rastreador de cliques codificado, como ad.doubleclick.net/clk. O cookie da DoubleClick é um número inteiro de 64 bits com no máximo 20 caracteres.

Os servidores de anúncios expandem a macro %m na click string que segue um evento de clique, eles não expandem a macro em um criativo.

• Se o usuário desativar cookies no seu navegador ou optar por não usá-los, o servidor de anúncios expandirá %m como 0.
• No código do criativo, a macro %m não tem efeito para navegadores que estão atrás de um proxy. Nesse caso, o servidor de anúncios também expandirá %m para zero.

%n — macro de número aleatório

A macro %n expande-se para um número aleatório. Números aleatórios impedem que os navegadores armazenem em cache um URL. Quando o anúncio é veiculado, os servidores de anúncios geram dinamicamente um número aleatório e o anexam ao URL no lugar de %n. Como haverá um novo número aleatório no URL cada vez que o anúncio for apresentado, o navegador não carregará uma versão armazenada em cache do anúncio. Quando você impede o armazenamento em cache, evita que servidores de terceiros tenham menos impressões.

A macro %n costuma ser utilizada pelo editor quando o Campaign Manager 360 precisa redirecionar a um terceiro para um criativo. Os terceiros normalmente têm sua própria sintaxe de números aleatórios, similar à ord=[random_number]? do Campaign Manager 360.

A macro %n também permite que terceiros rastreiem cliques. Como cada clique de usuário se expande em um número aleatório único no lugar da macro %n, os terceiros podem rastrear cada clique separadamente. Os coordenadores de publicidade devem confirmar com os terceiros se eles são compatíveis com a string de caracteres adicional que a macro formará ao se expandir.

%p — macro de correspondência de padrão

A macro %p se expande em uma substring encontrada no URL de solicitação das tags de anúncio. Quando o anúncio é veiculado, a macro se expande para tudo o que for encontrado entre a string inicial especificada e o caractere final.

Como designar a substring: use um par de valor-chave para definir o início e o fim do tipo de substring que você quer que o servidor pesquise. Um par de chave-valor consiste em duas chaves-valor: start_key_string e end_character.

• [start_key_string]: é a parte da chave de um par de chave-valor e precisa ser incluída nas tags de anúncio. Ela diferencia maiúsculas de minúsculas e não inclui os colchetes de marcador de posição.

• [end_character]: é o caractere usado para representar o final de uma chave-valor. Se um caractere final não for indicado, e a string de início for a última chave-valor de uma tag, o servidor de anúncios copiará a string inteira. É possível inserir cada um dos valores como qualquer string de valores ASCII. O valor precisa ter pelo menos dois caracteres e não incluir os colchetes de marcador de posição.

Veja o formato básico:

Normalmente, a macro %p é usada para se expandir em uma palavra-chave que ajuda a rastrear informações de relatórios. Por exemplo, se você quiser extrair um nome de modelo de carro, insira uma macro %p na tag de anúncio, além da string inicial (model=) e o caractere final escolhido (nesse caso, um ponto e vírgula). Novamente, os colchetes de marcador de posição não são incluídos:

Quando o anúncio é veiculado, o Campaign Manager 360 pesquisa model= nas tags de anúncio e captura tudo entre model= e o caractere final (;). 

Veja alguns usos comuns da macro %p:

• Os anunciantes podem transmitir valores ou variáveis de tags do Floodlight para tags dos editores.

• Os editores podem fazer transmissões dinâmicas de valores para URLs da página de destino.

%s — macro de nome-chave do site

A macro %s se expandirá de maneira diferente se você a adicionar às tags de anúncio ou às tags do Floodlight.

• As tags de anúncio se expandem para o nome-chave do site do Campaign Manager 360: quando um usuário clica em um anúncio veiculado pelo Campaign Manager 360, essa macro se expande para o nome-chave do site em que o anúncio foi veiculado. Esse nome-chave deverá coincidir com aquele listado na guia "Propriedades" do site no Campaign Manager 360 (Administrador > Sites).

  Por exemplo, veja este URL, que inclui a macro %s no final:

  http://www.advertiser.com/cgi.bin/?%s

  Se esse URL for incluído em um anúncio veiculado em um site com o nome-chave N255.010101.sandwiches, a macro se expandirá para formar N255.010101.sandwiches quando o usuário clicar no anúncio:

  http://www.advertiser.com/cgi.bin/?N255.010101.sandwiches

  Se as informações do site não estiverem disponíveis em tempo real, %s poderá se expandir para uma string vazia.

• As tags do Floodlight se expandem para o ID de site do Campaign Manager 360: quando uma tag do Floodlight é acionada em um site, a macro %s se expande para o ID do site. Esse é o código que o Campaign Manager 360 usará para identificar o site.

%u – macro do URL da página de destino

A macro %u se expande para o URL da página de destino de um criativo. Por exemplo, <a href="%u"> pode se expandir para o seguinte URL da página de destino:

Para inserir todo o URL do criativo de uma só vez, combine a macro %u com a %c. As duas macros se expandem para todo o URL: %c (string de clique) + %u (URL da página de destino) = um URL completo do criativo.

Por exemplo, se você inserir <a href="%c%u"> no código HTML, a macro poderá se expandir para:

http://ad.doubleclick.net/click;361119;0-8388608;2;321977;1-468|60;0|0|0;;?http%3A%2F%2Fwww.doubleclick.com%2Fpath%2Fpage.html