Macros são strings especiais no código do criativo. O Ad Manager substitui essas strings por outro valor ou código com base nas configurações do criativo. As macros são úteis para você não precisar atualizar diretamente o código do criativo se precisar fazer mudanças. Basta atualizar a referência da macro.
Para cada macro, fornecemos sugestões sobre como você pode usá-la, mas as macros podem ser usadas de qualquer maneira que seja mais útil para você. Elas podem ser incluídas em qualquer código processado pelo servidor de anúncios durante a exibição: código do criativo personalizado ou de terceiros, código do Studio, URLs de clique ou tags de anúncio.
Notas importantes sobre as macros
- Diferenciação de letras
As macros diferenciam maiúsculas de minúsculas. Use%%CACHEBUSTER%%, e não%%Cachebuster%%. - Expansões com e sem escape
As versões com e sem escape da macro se expandem de modo diferente. Saiba como usar macros com escape e sem escape. - Inserção de macro
O Ad Manager insere as macros automaticamente nos criativos de terceiros ou nos URLs de tag VAST, caso reconheça os terceiros. Para criativos personalizados e modelos de criativos, é preciso adicionar as macros manualmente. Se você não souber onde colocar a macro, entre em contato com o fornecedor do criativo.
Ao fazer a programação com um modelo de criativo, uma entrada de URL de clique só vai estar presente quando uma macro de clique for usada no modelo. - Caracteres reservados e codificação de URL (codificação percentual)
O Ad Manager reserva algumas letras minúsculas precedidas por um sinal de porcentagem:%a
%c
%h
%i
%n
%p
%kEssas strings não devem ser usadas na codificação de URL porque podem interferir na expansão da macro.
- As macros não são compatíveis com o Programático direto
Consulte os recursos disponíveis para o Programático direto.
Ir para uma macro específica na lista
Macros de renderização
As macros de renderização normalmente são usadas para renderizar criativos, garantindo que a aparência e o funcionamento deles estejam corretos.
Bloco de anúncios| Macro |
|---|
%%ADUNIT%% |
A macro de bloco de anúncios insere o caminho do bloco de anúncios em sua Tag do editor do Google no código do criativo quando é veiculado.
Veja como adicionar a macro ADUNIT a um snippet de código de criativo de terceiros:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
A macro do bloco de anúncios expande-se para o caminho completo do bloco de anúncios contido na solicitação de anúncio original, incluindo o código de rede. Este é um exemplo de como o caminho do bloco de anúncios se expande quando o anúncio é veiculado:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
Essa macro só funciona com blocos de anúncios sugeridos aprovados. Se o bloco de anúncios sugerido estiver no terceiro nível, a macro vai se expandir somente para o bloco de anúncios do segundo nível quando for usada no snippet do criativo. Quando o bloco de anúncios sugerido for aprovado, a macro vai se expandir para o bloco de anúncios do terceiro nível no snippet do criativo.
| Macro | Escape |
|---|---|
%%DEST_URL_ESC%% |
Com escape |
%%DEST_URL_ESC_ESC%% |
Com escape duplo |
%%DEST_URL_UNESC%% |
Sem escape |
A macro de URL de destino se expande no URL de clique do criativo, que é o mesmo do item de linha ou uma modificação definida para o criativo no item de linha.
A macro de URL de destino é útil em criativos personalizados e em modelos de criativos. Essa macro poderá ajudar se for necessário incluir o URL de clique no código do criativo e se o URL de clique for alterado conforme o criativo ou o modelo for usado em vários itens de linha.
Há três macros de URL de clique: com escape, com escape duplo e sem escape. Normalmente, a quantidade de escape (se você incluir ESC uma vez, duas vezes ou nenhuma vez) depende da empresa terceirizada de rastreamento de cliques. Algumas dessas empresas exigem que o URL tenha escape, outras não. Em geral, o nível de escape exigido por uma empresa de rastreamento de cliques de terceiros é especificado com a string click= na tag de anúncio de terceiro ou no código do criativo personalizado no Ad Manager:
-
click=: com um escape (%%DEST_URL_ESC%%). -
click0=: sem escape (%%DEST_URL_UNESC%%). -
click1=: com um escape (%%DEST_URL_ESC%%). -
click2=: com dois escapes (%%DEST_URL_ESC_ESC%%).
%%DEST_URL%%, que faz exatamente o mesmo que %%DEST_URL_ESC%%. Recomendamos o uso de %%DEST_URL_ESC%% para ter mais clareza, mas não é necessário codificar criativos e modelos mais antigos novamente.%u ou %%DEST_URL%%, você verá o URL de xsd:string ao clicar no criativo. Ele tem um tamanho máximo de 1.024 caracteres.| Macro |
|---|
%%FILE:file_display_name%% |
A macro de servidor de arquivos %%FILE:file_display_name%% abre o URL completo do material do criativo enviado por upload. Use essa macro para chamar os recursos enviados, como uma imagem, com o código personalizado do criativo.
Para usar essa macro, substitua file_display_name pelo nome de exibição do material do criativo, conforme ele aparece no Ad Manager ao visualizar os detalhes do criativo.
| Macro |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Essas macros inserem a altura e a largura do criativo, como definido no Ad Manager pelo valor do campo "Segmentar tamanho do bloco de anúncios", no código personalizado de um criativo durante o processo de veiculação de anúncios.
As macros de altura e de largura poderão ser especialmente úteis se você criar um modelo de criativo para reutilizar com criativos de tamanhos diferentes. Em vez de codificar o tamanho de cada criativo, é possível deixar as macros de altura e largura inserir os valores em cada criativo dinamicamente.
| Macro |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
Use a macro de correspondência de padrão para transferir uma ou mais variáveis personalizadas, como um valor de segmentação para um criativo. É possível usar essa macro para passar chaves-valor, substituir toda a string de segmentação ou expandir o URL referenciador. Isso poderá ser útil se você quiser exibir criativos diferentes com base nas informações que tiver sobre um usuário, como preferências de conteúdo.
A macro de correspondência de padrão tem um limite de cem substituições por criativo.
Realizar o escape da macro de correspondência de padrão
A macro de correspondência de padrão retorna o valor como recebido. Se você usa a macro em um dos campos de URL, como o campo "URL de tag VAST" ou "URL de rastreamento de terceiros" em um criativo de vídeo, é possível que o valor expandido retorne com escape. Para fazer isso, é necessário fazer o escape triplo do valor na solicitação.
%%PATTERN:key%%
Por exemplo, digamos que você tenha dois criativos para determinado item de linha, cada um projetado para atrair usuários do sexo feminino e do masculino, separadamente. A "chave" usada na macro precisa ser caracteres alfanuméricos ou o sublinhado (_).
Veja como o processo funciona:
- Você informa o valor personalizado (neste caso, o sexo do usuário) a uma tag de anúncio na sua página por chaves-valor:
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - No criativo personalizado ou de terceiros, informe dinamicamente o valor personalizado (o sexo do usuário) usando a macro:
<some creative script here>...&gender=%%PATTERN:gender%% - Toda a macro de
%%PATTERN:gender%%será substituída pormale. - O Ad Manager chamará o arquivo do criativo "male" e o veiculará para esse usuário.
%%PATTERN:TARGETINGMAP%%
É possível usar %%PATTERN:TARGETINGMAP%% para substituir todo o mapa de segmentação e criar dinamicamente as tags de passback.
Veja como adicionar a macro TARGETINGMAP a uma tag de anúncio:
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
Este é um exemplo da string completa de chave-valor quando o anúncio é veiculado:
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
Use essa macro para configurar uma tag de passback entre duas redes do Ad Manager (Rede A e Rede B).
Este é um exemplo de criativo reservado na Rede A do Ad Manager:
<script type='text/javascript' src='http://www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads().definePassback('/network_B/Homepage', [468, 60])
.setTargeting("myAdUnit", "%%ADUNIT%%")
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.display();
</script>
Caso a Rede B do Ad Manager não tenha uma campanha vendida para veiculação, ela pode devolver a impressão para a Rede A usando um criativo de passback como este:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('%%PATTERN:myAdUnit%%', [468, 60])
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.setTargeting("kwd", "noloop") // to avoid infinite loops
.display();
</script>Também é possível usar TARGETINGMAP em uma tag de passback enviada em uma solicitação para um servidor de anúncios de terceiros. Isso permite que você tenha vários valores em um criativo dinâmico.
Veja este exemplo de criativo reservado no Ad Manager:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=%%ADUNIT%%&targeting='+encodeURIComponent(JSON.stringify(%%PATTERN:TARGETINGMAP%%))+'"></scr'+'ipt>');
</script>
Quando veiculado pelo Ad Manager, o criativo se expande para:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=/network_A/first_level_ad_unit/second_level_ad_unit&targeting=%7B%22kw%22%3A%5B%22testpercentp%22%5D%7D"></scr'+'ipt>');
</script>
Agora o terceiro tem acesso aos parâmetros dfpAdUnit e targeting gerados dinamicamente e pode criar a seguinte passback:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('/network_A/first_level_ad_unit/second_level_ad_unit', [728, 90])
.setTargeting("kw", "noloop") // to avoid infinite loop (see https://support.google.com/admanager/answer/2811375)
.updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>
Para fazer isso, o terceiro pode receber uma atribuição de um código do modelo parecido com este:
myTargetingObject = JSON.parse('$targeting'); document.write('<sc'+'ript src="https://www.googletagservices.com/tag/js/gpt.js"></scr'+'ipt>');
document.write('<scr'+'ipt>');
callback = function() {
googletag.pubads().definePassback('$dfpAdUnit', [728, 90])
.setTargeting("kwd", "noloop")
.updateTargetingFromMap(myTargetingObject)
.display();
};
window.googletag = window.googletag || {};
googletag.cmd = googletag.cmd || [];
googletag.cmd.push(callback);
document.write('</sc'+'ript>'); %%PATTERN:url%%
Também é possível usar a chave reservada url para expandir para o URL da página de referência.
url é uma chave reservada. As chaves-valor nas suas tags do Campaign Manager 360 que tiverem url como o nome da chave serão substituídas pelo URL do referenciador.
| Macro |
|---|
%%TAG_PARAM%% |
A macro de parâmetro de tag é usada junto com outros parâmetros de tag de anúncio e só está disponível para ser usada com os seguintes parâmetros:
Quando compatível, ela se expande para o valor do parâmetro.
Por exemplo, %%TAG_PARAM:correlator%% (compatível) se expande para o valor de correlator da tag de anúncio, mas %%TAG_PARAM:ppid%% (incompatível) não se expande para nenhum valor.
| Macro |
|---|
%%TARGET_IN_NEW_WINDOW%% |
A macro de destino em nova janela indica se a configuração de janela de destino especificada para o bloco de anúncios em que um criativo é veiculado é "_blank" (nova janela) ou outra.
-
Se a janela de destino for
_blank, a macro se expandirá para1. -
Se a janela de destino tiver outro valor ou se nenhuma janela de destino for especificada, a macro se expandirá para
0.
Use a macro %%TARGET_WINDOW%% caso você queira inserir o valor real da configuração de janela de destino.
| Macro |
|---|
%%TARGET_WINDOW%% |
A macro de janela de destino expande-se na janela especificada do bloco de anúncios em que o criativo é veiculado. É possível usar a macro no código de um criativo para especificar se um clique no criativo direcionará o usuário para uma nova janela ou carregará a página de destino na mesma janela, dependendo das configurações de cada site em que os usuários veem o anúncio.
Por exemplo, o bloco de anúncios AdManager_News.com tem a janela de destino definida como _top e o bloco AdManager_Fashion.com como _new. Se a macro %%TARGET_WINDOW%% estiver incluída no código do criativo, ela vai ser expandida em _top para usuários do AdManager_News.com e _new para usuários do AdManager_Fashion.com.
Veja um exemplo de implementação:
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
Use a macro %%TARGET_IN_NEW_WINDOW%% caso você queira determinar que o valor de configuração de janela de destino seja "_blank" ou outro valor.
| Macro |
|---|
%%TFCD%% |
A tag para conteúdo direcionado a crianças (TFCD, na sigla em inglês) permite que você informe a terceiros que uma determinada solicitação de anúncio vem de uma página com conteúdo feito para crianças. O objetivo dessa macro é auxiliar no cumprimento da Lei de Proteção da Privacidade On-line das Crianças (COPPA).
É possível incluir a macro em qualquer redirecionamento ou solicitação de criativos de terceiros, no formato coppa=%%TFCD%% ou semelhante. Ela também pode ser utilizada em JavaScript para definir solicitações de tags de passback da GPT do tratamento para direcionamento a crianças. A macro se expande para 1 no caso de conteúdo feito para crianças ou para 0 no caso de outros conteúdos com base nas informações sobre a natureza da página, do site ou dos apps para dispositivos móveis que enviam a solicitação ao Ad Manager.
Se você usar os serviços de publicidade do Google e quiser implementar o tratamento para direcionamento a crianças no nível do site ou do aplicativo, consulte Marcar o tratamento para direcionamento a crianças em um site ou um aplicativo.
| Macro |
|---|
[%URI_ENCODE:variable%] |
A macro de codificação de URI traduz os espaços e outros caracteres especiais em valores das variáveis de modelo de criativo para serem utilizados em URIs, também conhecidos como URLs.
Exemplo
Digamos que seu modelo de criativo tem uma variável "lista" chamada "Cor" com dois valores: "azul-escuro" e "verde-claro". Por padrão, o Ad Manager adiciona [%Color%] ao snippet do modelo de criativo:
<a href="https://paint.com/wall.html?color=[%Color%]">Paint!</a>
Quando o criativo é gerado, o Ad Manager substitui [%Color%] pela string de texto literal do item selecionado na lista. Neste exemplo, as strings de texto literal contêm caracteres de espaço, o que fará com que o URL não funcione, já que os caracteres de espaço precisam ser codificados. Use [%URI_ENCODE:Color%] para evitar esse problema.
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Paint!</a>
[%Color%] |
azul escuro |
[%URI_ENCODE:Color%] |
azul%20escuro |
Essa macro é muito útil ao usar uma variável do modelo de criativo para definir um URL de clique ou de redirecionamento. Sem a codificação certa, o URL completo no seu criativo pode não funcionar.
Exemplo
Digamos que seu modelo de criativo tem uma variável "URL" chamada "LandingPage". Por padrão, o Ad Manager adiciona [%LandingPage%] ao seu snippet do modelo de criativo:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Click here!</a>
Caso o URL [%LandingPage%] inclua parâmetros de consulta, como ?page=home&sport=baseball, o URL ficará incorreto e o redirecionamento não funcionará. Nesse exemplo, o conteúdo após o "e" comercial (&) será atribuído ao URL completo em vez de ao URL de redirecionamento. Use [%URI_ENCODE:LandingPage%] para evitar esse problema.
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Click here!</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Macros de rastreamento
Essas macros são mais usadas para fins de monitoramento e geração de relatórios.
Cachebuster (número aleatório)| Macro |
|---|
%%CACHEBUSTER%% |
A macro cachebuster garante que uma nova chamada seja feita ao servidor de anúncios toda vez que o código for executado para que você possa contabilizar as impressões com precisão. Se você não adicionar a macro de impedimento de cache ao código do criativo, haverá uma maior probabilidade de discrepâncias na contagem de impressões entre o Google Ad Manager e o servidor de anúncios de terceiros. Nem todos os terceiros requerem a macro cachebuster.
A maioria dos fornecedores de criativos oferecerá um marcador na tag para inserir as macros inibidoras de cache. Por exemplo, se o código do criativo de terceiros tiver:
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]
Selecione [RANDOM_NUMBER] e clique no botão Inserir Macro cachebuster para substituir o marcador:
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER. Isso reduzirá as discrepâncias ao usar o rastreador de impressões do Campaign Manager 360 para o Ad Manager.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
As macros cachebuster nas respostas VAST
A macro %%CACHEBUSTER%% expande-se para o mesmo número aleatório em todos os eventos de determinado criativo. Isso é particularmente útil no caso de anúncios em vídeo, porque a macro se expande para o mesmo número aleatório em cada evento de rastreamento de vídeo em uma resposta VAST.
| Macro | Escape |
|---|---|
%%CLICK_URL_UNESC%% |
Sem escape |
%%CLICK_URL_ESC%% |
Com escape |
%%CLICK_URL_ESC_ESC%% |
Com escape duplo |
A macro de clique se expande para um URL especial. Assim você pode rastrear cliques no Ad Manager para os criativos de terceiros. Em geral, essa macro é pareada com o URL de clique de um criativo na tag âncora (<a>). Não insira a macro de clique como origem de uma imagem ou iframe. Essa ação resulta no registro de um clique toda vez que a imagem ou o iframe forem renderizados, gerando um clique não legítimo que é filtrado como um clique inválido.
Use %%CLICK_URL_UNESC%% no início de um link. Use %%CLICK_URL_ESC%% quando o rastreador de cliques for o parâmetro de outro URL.
<a href="%%CLICK_URL_UNESC%%http://www.google.com">link</a>
<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">link</a>
Saiba mais sobre macros com escape e macros sem escape.
Verificar sua implementação da macro de clique
Uma macro de clique colocada incorretamente não rastreará cliques. Siga estas etapas para confirmar se o Ad Manager registrará os cliques como você pretende.
- Visualize o criativo.
- Clique na visualização.
O Ad Manager exibe uma confirmação de que os cliques serão registrados. Caso você não veja essa confirmação, sua macro de clique não foi implementada corretamente.
| Macro | No que se expande |
|---|---|
%eaid! |
Código do item de linha |
%eadv! |
Código do anunciante para o item de linha veiculado |
%ebuy! |
Código do pedido para o item de linha veiculado |
%ecid! |
ID do criativo |
%eenv! |
Indicador de ambiente (tipo de tag): i para iframe e j para JavaScript |
%epid! |
Código do bloco de anúncios no qual o item de linha é veiculado |
%esid! |
Código do bloco de anúncios de nível mais alto acima do bloco em que o item de linha é veiculado
Esta é uma macro legada e pode não funcionar como esperado na sua rede.
|
Use as macros de expansão no código do criativo personalizado ou em um URL de clique para exibir os valores de código do Ad Manager ao veicular criativos em uma página. Isso é muito usado para corresponder códigos do Ad Manager a códigos do próprio banco de dados de um editor para a solução de problemas ou geração de outros relatórios.
As macros de expansão podem ser separadas no URL de clique por qualquer caractere seguro para o uso nos URLs de clique do Ad Manager. Por exemplo, http://www.site.com/?%eaid!;%ecid! é expandido para http://www.site.com/?1234567;4265598.
| Macro |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (o identificador do dispositivo) |
%%ADVERTISING_IDENTIFIER_TYPE%% (o tipo do dispositivo) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (a configuração Limite de rastreamento de anúncios) |
A macro %%ADVERTISING_IDENTIFIER_PLAIN%% permite que os editores no app enviem um ID de dispositivo reconfigurável para que os parceiros de publicidade veiculem anúncios com base em interesses. Isso facilita a concessão de acesso ao ID de dispositivo reconfigurável a seus anunciantes e agências.
Os editores no app também podem usar a macro %%ADVERTISING_IDENTIFIER_TYPE%% para enviar o tipo de dispositivo e a macro %%ADVERTISING_IDENTIFIER_IS_LAT%% para enviar o Limite de rastreamento de anúncios (LAT, na sigla em inglês), que indica o indicador "Limite de rastreamento de anúncios" de um dispositivo.
Saiba mais sobre os IDs de dispositivos reconfiguráveis para segmentação de usuários, que incluem os tipos de dispositivos compatíveis.
Pré-requisitos
Configurar a criptografia de HTTPS para criativos. Essa é uma exigência para o criativo, bem como para qualquer pixel de terceiros que você usar no acompanhamento de conversões. Se os criativos não estiverem criptografados para HTTPS ou se você modificar a compatibilidade automática de SSL, a macro não vai expandir o valor, mas os criativos ainda serão veiculados.
Como funciona
- No Ad Manager, o editor inclui as macros nos URLs de criativo e/ou rastreamento.
-
As macros se expandem para incluir o ID do dispositivo do usuário, o tipo de dispositivo e/ou a configuração LAT, que são incluídos no criativo durante as chamadas para o terceiro.
A macro do identificador não vai se expandir se a solicitação de anúncio for de um app feito para crianças (TFCD) ou se o Limite de rastreamento de anúncios (LAT) estiver ativado. Nesses casos, essa macro retorna uma string vazia ("").
Formato
Essa macro envia um valor hexadecimal de 32 dígitos maiúsculos, exibido em cinco grupos e separados por hifens, no formato 8-4-4-4-12 para um total de 36 caracteres (32 caracteres alfanuméricos e quatro hifens).
Exemplo: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Veja os valores possíveis para tipos de dispositivos compatíveis e Limite de rastreamento de anúncios (LAT).
| Macro |
|---|
%%PREVIEW_MODE%% |
Use a macro do modo de visualização no código do criativo personalizado para evitar a contagem de impressões de visualização pelos sistemas de back-end ou de terceiros. A macro se expandirá para true se o criativo for visto como uma visualização do Ad Manager e para false se for uma impressão regular.
| Macro |
|---|
%%SCHEME%% |
A macro de esquema expande-se para http: ou https:, o que corresponde ao esquema de segurança da página da Web em que um criativo é veiculado. É possível colocá-la no início de um URL.
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| Macro |
|---|
%%SITE%% |
Expande-se para o domínio do parâmetro de URL em uma tag de anúncio (por exemplo, google.com). A macro pode ser usada para modificar seu criativo com base no local de onde veio a solicitação. Ela não funciona em anúncios do Ad Exchange marcados como anônimos.
| Macro | Escape |
|---|---|
%%VIEW_URL_ESC%% |
Com escape |
%%VIEW_URL_UNESC%% |
Sem escape |
A macro de impressão visualizada permite que o Ad Manager conte uma impressão cada vez que um criativo é transferido por download para o dispositivo do usuário e começa a ser carregado. Use essa macro somente em criativos fora da página.
Existem várias maneiras de enviar um ping de exibição. Recomendamos usar uma tag <img>:
<!-- This img tag is invisible. It makes the browser send a request to the VIEW_URL. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">
<!-- This img tag shows the real ad.-->
<img src="[%Imagefile%]" border="0">
A primeira tag <img> recupera uma imagem 1 x 1 de VIEW_URL. Defina o estilo de “display:none” para que fique oculto e não afete o layout da página.
Macros de solicitação de anúncio para GDPR
Essas macros são usadas com mais frequência com solicitações de anúncios que estão sujeitas ao GDPR.
GDPR| Macro |
|---|
${GDPR} |
Expande-se para o valor de gdpr= associado à solicitação.
| Macro |
|---|
${GDPR_CONSENT_XXXX} |
Expande-se para a string de transparência e consentimento (TC) associada à solicitação. Se a string de TC estiver em branco ou for inválida, essa macro não irá se expandir. Use essa macro para transmitir a string de TC a um fornecedor de criativos terceirizado por um URL em criativos não programáticos.
Substitua XXXX pelo ID do fornecedor terceirizado na GVL do IAB. Se a string de TC estiver em branco ou for inválida, esta macro não irá se expandir.
Criativos com a macro ${GDPR_CONSENT_XXXX} talvez sejam bloqueados se o provedor terceirizado associado ao ID na GVL do IAB inserido não tiver o consentimento do usuário.
Quando for usada em uma tag VAST e o provedor terceirizado não tiver o consentimento do usuário, essa macro não irá se expandir.
A macro ${GDPR_CONSENT_XXXX} deve ocorrer apenas uma vez no URL. Entre em contato com o fornecedor terceirizado de criativos para entender os requisitos de transmissão da string de TC e as restrições de tamanho do URL. A macro será substituída em solicitações relevantes do TCF v2.0 do IAB pela string de TC completa e não modificada.
As macros da Estrutura de Transparência e Consentimento (TCF) não se expandem quando são implementadas no HTML de um criativo HTML5. Somente criativos de exibição com redirecionamento e de exibição personalizada são compatíveis com a expansão das macros do TCF pelos campos "URL de terceiros" e "Código HTML", respectivamente.
| Macro |
|---|
${ADDTL_CONSENT} |
Expande-se para a string de consentimento adicional (AC, na sigla em inglês) associada à solicitação.
| Macro |
|---|
%%TFUA%% |
Expande-se para o valor de 1 e marca a solicitação para usuários do EEE e do Reino Unido abaixo da idade de consentimento.
Macros de vídeo
Essas macros são muito usadas em criativos de vídeo para incluir detalhes sobre o contexto ou conteúdo.
Duração do anúncio em vídeo em milissegundos| Macro |
|---|
%%VIDEO_AD_DURATION%% |
É expandida para a duração do anúncio em vídeo em milésimos de segundos. Para wrappers/redirecionamentos VAST, a macro se expande para a duração do anúncio declarada no Ad Manager.
| Macro | Escape |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Sem escape |
%%DESCRIPTION_URL_ESC%% |
Com escape |
%%DESCRIPTION_URL_ESC_ESC%% |
Com escape duplo |
Use %%DESCRIPTION_URL_ESC%% (com escape único) quando a macro estiver dentro de um URL e %%DESCRIPTION_URL_UNESC%% (sem escape) em outros contextos. Saiba mais sobre macros com escape e sem escape
Em tags de anúncio de redirecionamento, essas macros se expandem para o parâmetro de URL de descrição a partir do parâmetro de consulta description_url da Tag do editor do Google original. Em geral, o URL de descrição deve ser idêntico ao URL do referenciador. Será preciso especificar o description_url na Tag do editor do Google se houver incorporações em que o SDK do IMA não possa detectar com precisão o URL da página ou se você usar vídeos no Ad Exchange ou no Google AdSense para vídeos.
%%DESCRIPTION_URL%%, que faz exatamente o mesmo que %%DESCRIPTION_URL_UNESC%%. Por isso, não é necessário recodificar criativos e modelos antigos.| Macro | Escape |
|---|---|
%%REFERRER_URL_UNESC%% |
Sem escape |
%%REFERRER_URL_ESC%% |
Com escape único |
%%REFERRER_URL_ESC_ESC%% |
Com escape duplo |
Use %%REFERRER_URL_ESC%% (com escape único) quando a macro estiver dentro de um URL e %%REFERRER_URL_UNESC%% (sem escape) em outros contextos. Saiba mais sobre macros com escape e sem escape
Essa macro se expande para o URL do referenciador (o URL da página em que o player de vídeo está localizado) em tags de anúncio de redirecionamento. Isso é feito da seguinte maneira: o Ad Manager analisa o parâmetro de consulta do URL da tag de anúncio, isola o URL do referenciador e substitui o texto da macro pelo URL. Isso funciona somente com o SDK do Google IMA, com as seguintes qualificações:
- É preciso que o acesso ao script esteja ativado na página para que essa macro funcione.
- A macro não funciona em um iframe.
%%REFERRER_URL%%, que faz exatamente o mesmo que %%REFERRER_URL_UNESC%%. Por isso, não é necessário recodificar criativos e modelos mais antigos.Macros de conteúdo em vídeo
Essas macros são usadas para anúncios que segmentam origens do conteúdo em vídeo.
| Macro |
|---|
%%VIDEO_DURATION%% |
Expande-se na duração do vídeo em milésimos de segundos.
| Macro |
|---|
%%VIDEO_ID%% |
Expande-se para o ID do conteúdo de vídeo em exibição no momento, que é o código exclusivo no CMS ou o valor de dfpvideo:ContentID do MRSS.
| Macro |
|---|
%%VIDEO_METADATA:key%% |
Expande-se nos metadados do vídeo em que o criativo é veiculado com base nas chaves-valor associadas ao conteúdo do vídeo. As chaves-valor são configuradas na guia "Vídeo" do Ad Manager.
Quando uma chave de metadados de vídeo é segmentada, ela pode ser expandida pela macro de metadados de vídeo. A "chave" usada na macro precisa ser caracteres alfanuméricos ou o sublinhado (_).
| Macro | Escape |
|---|---|
%%VIDEO_TITLE%% |
Com escape único |
A macro de título do vídeo se expande para exibir o título de um vídeo, como definido no Ad Manager.
O processamento do conteúdo é necessário para que essa macro funcione.
| Macro |
|---|
%%FW_CAID%% |
Expande-se no ID de anúncio personalizado FreeWheel.
Essa macro só se aplica a editores que usam o FreeWheel para veicular anúncios em vídeo.
| Macro |
|---|
%%IAB_CATEGORIES%% |
Usada para passar categorias de anúncios para criativos classificados manualmente com rótulos. Essa macro retorna uma lista separada por vírgulas de categorias IAB padrão aplicáveis convertidas dos classificadores do Google.
Ela pode ser usada por editores que compartilham inventário de vídeo com o FreeWheel e querem passar categorias de anúncios como parâmetros personalizados. Por exemplo, é possível adicionar &iab_categories=%%IAB_CATEGORIES%% à tag de redirecionamento VAST.
