As macros são strings especiais no código de criativo. Posteriormente, o Ad Manager substitui esta string por outro valor ou código baseado nas definições de um criativo. As macros são úteis porque não precisa de atualizar diretamente o código de criativo se precisar de efetuar alterações, pode atualizar a referência da macro.
Para cada macro, fornecemos sugestões sobre a sua utilização, mas é possível utilizar macros para o que for mais importante. É possível incluir macros em qualquer código processado pelo servidor de anúncios durante o fornecimento: código de criativo personalizado ou de terceiros, código do Studio, URLs de clique ou etiquetas de anúncios.
Notas importantes sobre macros
- Sensibilidade a maiúsculas e minúsculas
As macros são sensíveis a maiúsculas e minúsculas. Utilize%%CACHEBUSTER%%, mas não%%Cachebuster%%. - Expansão com e sem caráter de escape
As versões de macros com e sem caráter de escape expandem-se de forma diferente. Saiba como utilizar macros com e sem caráter de escape. - Inserção de macros
Para criativos de terceiros ou URLs de etiquetas VAST, o Ad Manager insere as macros automaticamente se reconhecer a entidade de terceiros. Para criativos personalizados e modelos de criativos, é necessário adicionar as macros manualmente. Se não tiver a certeza acerca de onde colocar uma macro, contacte o fornecedor do criativo.
Ao gerir o tráfego com um modelo de criativo, uma entrada de URL de clique só vai estar presente quando for usada uma macro de clique no modelo. - Carateres reservados e codificação de URL (codificação de percentagem)
O Ad Manager reserva determinadas letras minúsculas precedidas por uma percentagem:%a
%c
%h
%i
%n
%p
%kEstas strings não devem ser utilizadas na codificação de URL, uma vez que podem interferir com a expansão de macros.
- As macros não são suportadas no Direcionamento programático
Consulte as funcionalidades disponíveis para o Direcionamento programático.
Avance para uma macro específica na lista
Macros de renderização
Estas macros são utilizadas sobretudo na conversão de criativos para garantir o aspeto adequado e o funcionamento correto.
Bloco de anúncios| Macro |
|---|
%%ADUNIT%% |
A macro do bloco de anúncios insere o caminho do bloco de anúncios a partir da Etiqueta do Publicador Google no código de criativo quando este é publicado.
Veja como pode adicionar a macro ADUNIT a um fragmento 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 no pedido de anúncio original, incluindo o código de rede. Segue-se um exemplo de como o caminho do bloco de anúncios se expande quando o anúncio é publicado:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
Esta macro funciona apenas para blocos de anúncios sugeridos aprovados. Se o bloco de anúncios sugerido estiver no terceiro nível, esta macro expande-se apenas para o bloco de anúncios do segundo nível quando é utilizada no fragmento do criativo. Após a aprovação do bloco de anúncios sugerido, a macro expande-se para o terceiro nível do bloco de anúncios no fragmento do criativo
| Macro | Carateres de escape |
|---|---|
%%DEST_URL_ESC%% |
Com caráter de escape |
%%DEST_URL_ESC_ESC%% |
Com carateres de escape duplo |
%%DEST_URL_UNESC%% |
Sem caráter de escape |
A macro de URL de destino expande para o URL de clique do criativo, que é o URL de clique do elemento publicitário ou um conjunto de substituição para o criativo incluído no elemento publicitário.
A macro de URL de destino é útil para criativos personalizados e modelos de criativos. Se o código do criativo necessitar de incluir o URL de clique do criativo e este mudar à medida que o criativo ou o modelo é utilizado em elementos publicitários diferentes, esta macro pode ajudar.
Existem três macros de URL de clique: com caráter de escape, com carateres de escape duplo e sem caráter de escape. Normalmente, o número de carateres de escape (quer inclua ESC uma vez, duas ou nenhuma) depende da empresa terceira de acompanhamento de cliques. Algumas empresas de terceiros de controlo de cliques requerem que o URL contenha carateres de escape e outras não. O nível de carateres de escape requerido por uma empresa de controlo de cliques de terceiros é muitas vezes especificado na etiqueta com a string click= na etiqueta de anúncio de terceiros ou no código de criativo personalizado no Ad Manager:
-
click=: incluir caráter de escape uma vez (%%DEST_URL_ESC%%). -
click0=: Não incluir caráter de escape (%%DEST_URL_UNESC%%). -
click1=: incluir caráter de escape uma vez (%%DEST_URL_ESC%%). -
click2=: incluir caráter de escape duas vezes (%%DEST_URL_ESC_ESC%%).
%%DEST_URL%%, que faz exatamente o mesmo que %%DEST_URL_ESC%%. Recomendamos a utilização de %%DEST_URL_ESC%% para maior clareza, mas não há necessidade de recodificar criativos e modelos mais antigos.%u ou %%DEST_URL%%, é direcionado para o URL xsd:string quando clicar no criativo. Tem um comprimento máximo de 1024 carateres.| Macro |
|---|
%%FILE:file_display_name%% |
A macro de servidor de ficheiros %%FILE:file_display_name%% expande-se para o URL completo de um recurso do criativo carregado para um criativo. Utilize esta macro para chamar os recursos carregados, como uma imagem, com um código de criativo personalizado.
Para utilizar esta macro, substitua file_display_name pelo nome a apresentar do recurso do criativo, conforme apresentado no Ad Manager quando visualiza os detalhes do criativo.
| Macro |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Estas macros inserem a altura e a largura do criativo, conforme definido no Ad Manager pelo valor do campo "Tamanho do bloco de anúncios segmentado" do criativo, no código personalizado de um criativo durante o processo de publicação de anúncios.
As macros de altura e largura podem ser especialmente úteis se estiver a criar um modelo de criativo que pretenda reutilizar com criativos de tamanhos diferentes. Em vez de codificar o tamanho de cada criativo, pode permitir que as macros de altura e largura insiram os valores em cada criativo dinamicamente.
| Macro |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
Utilize a macro de correspondência de padrões para transmitir uma ou mais variáveis personalizadas, como um valor de segmentação, para um criativo. Pode utilizar esta macro para transmitir chaves-valores, substituir toda a string de segmentação ou expandir o URL do referenciador. Isto pode ser útil se pretender publicar criativos diferentes com base nas informações de que dispõe acerca de um utilizador, como as respetivas preferências de conteúdo.
A macro de correspondência de padrões está limitada a 100 substituições por criativo.
Carateres de escape na macro de correspondência de padrões
A macro de correspondência de padrões devolve o valor conforme recebido. Se estiver a utilizar a macro num dos campos do URL, tal como o campo "URL da etiqueta VAST" ou "URL de acompanhamento de terceiros" num criativo de vídeo, pode pretender que o valor expandido seja devolvido com carateres de escape. Para isso, precisa de adicionar carateres de escape triplo ao valor no pedido.
%%PATTERN:key%%
Por exemplo, pode ter dois criativos para um determinado elemento publicitário: um concebido para agradar ao público feminino e outro para agradar ao público masculino. A "chave" utilizada na macro deve conter carateres alfanuméricos ou o caráter de sublinhado (_).
O processo funciona do seguinte modo:
- Está a transmitir o valor personalizado (neste caso, o sexo do utilizador) para uma etiqueta do anúncio na página através de chaves-valores:
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - No criativo personalizado ou de terceiros, transmita dinamicamente o valor personalizado (o género do utilizador) com a seguinte macro:
<some creative script here>...&gender=%%PATTERN:gender%%. - A macro completa de
%%PATTERN:gender%%será substituída por "male". - O Ad Manager chama e publica o ficheiro do criativo "male" para este utilizador.
%%PATTERN:TARGETINGMAP%%
Pode utilizar %%PATTERN:TARGETINGMAP%% para substituir todo o mapa de segmentação e criar etiquetas de passback de forma dinâmica.
Veja como pode adicionar a macro TARGETINGMAP a uma etiqueta do anúncio:
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
Segue-se um exemplo da string de valor-chave completa quando o anúncio é publicado:
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
Pode utilizar esta macro para configurar uma etiqueta de passback entre duas redes do Ad Manager ("Rede A" e "Rede B").
Segue-se um exemplo de um 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>
Se a Rede B do Ad Manager não tiver qualquer campanha vendida para publicação, pode devolver a impressão à Rede A através de um criativo de passback como o seguinte:
<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>De igual modo, pode utilizar TARGETINGMAP numa etiqueta de passback enviada num pedido a um servidor de anúncios de terceiros, o que lhe permite ter vários valores num criativo dinâmico.
Segue-se um 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 é publicado no Ad Manager, este exemplo expande-se 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, os terceiros têm acesso aos parâmetros "dfpAdUnit" e "targeting" gerados de forma dinâmica e podem criar o 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 o fazer, os terceiros podem receber um código do modelo semelhante a 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%%
De igual modo, pode utilizar a chave reservada url para expandir para o URL da página de referência.
Tenha em atenção que url é uma chave reservada. Todas as chaves-valores das suas etiquetas do Campaign Manager 360 que tenham url como o nome da chave serão substituídas pelo URL do referenciador.
| Macro |
|---|
%%TAG_PARAM%% |
A macro de parâmetro de etiqueta é usada em conjunto com outros parâmetros da etiqueta do anúncio e só está disponível para utilização com os seguintes parâmetros:
Quando suportado, expande-se para o valor do parâmetro.
Por exemplo, %%TAG_PARAM:correlator%% (suportado) é expandido para o valor do correlator da etiqueta do anúncio, mas %%TAG_PARAM:ppid%% (não suportado) não é expandido para nenhum valor.
| Macro |
|---|
%%TARGET_IN_NEW_WINDOW%% |
A macro de destino numa nova janela indica se a definição de janela de destino especificada para o bloco de anúncios em que um criativo é publicado é "_blank" (nova janela) ou outra.
-
Se a janela de destino for
_blank, a macro expande-se para1. -
Se a janela de destino for qualquer outro valor, ou se não for especificada nenhuma janela de destino, a macro expande-se para
0.
Utilize a macro %%TARGET_WINDOW%% se pretender inserir o valor da definição da janela de destino real.
| Macro |
|---|
%%TARGET_WINDOW%% |
A macro de janela de destino expande-se para a janela de destino especificada para o bloco de anúncios em que um criativo é publicado. Pode utilizar a macro no código de um criativo para especificar se um clique no criativo direciona o utilizador para uma nova janela ou se carrega a página de destino na mesma janela, dependendo das definições de cada site em que os utilizadores vejam o anúncio.
Por exemplo, o bloco de anúncios AdManager_News.com tem a janela de destino definida como _top e o bloco de anúncios AdManager_Fashion.com tem-na definida como _new. Se a macro %%TARGET_WINDOW%% estiver incluída no código do criativo, esta expande-se para _top para os utilizadores em AdManager_News.com e _new para os utilizadores de AdManager_Fashion.com.
Segue-se um exemplo de uma implementação:
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
Utilize a macro %%TARGET_IN_NEW_WINDOW%% se pretender determinar se o valor da definição da janela de destino é "_blank" ou outro valor.
| Macro |
|---|
%%TFCD%% |
A etiqueta para conteúdo dirigido a crianças (TFCD) permite-lhe informar as entidades de terceiros que um determinado pedido de anúncio é proveniente de uma página com conteúdo dirigido a crianças. A macro tem a finalidade de auxiliar na conformidade com a Lei de Proteção à Privacidade da Criança na Internet (COPPA).
Pode incluir a macro em quaisquer redirecionamentos ou pedidos de criativos de terceiros, no formato coppa=%%TFCD%% ou algo semelhante. Também é possível utilizar a macro em JavaScript para definir pedidos com etiquetas de passback da GPT para tratamento dirigido a crianças. A macro expande-se para 1 para conteúdo dirigido a crianças ou 0 para outro conteúdo, com base nas informações relativas à natureza da página, site ou app para dispositivos móveis que enviou o pedido ao Ad Manager.
Se estiver a utilizar os serviços de publicidade da Google e pretender implementar um tratamento dirigido a crianças ao nível do site ou da app, consulte Etiquete um site ou uma app para tratamento dirigido a crianças.
| Macro |
|---|
[%URI_ENCODE:variable%] |
A macro de codificação de URI converte corretamente os espaços e outros carateres especiais em valores de variáveis de modelos de criativos para utilização em URIs, também conhecidos como URLs.
Exemplo
Por exemplo, o modelo de criativo tem uma variável de "lista" denominada "Color" com dois valores: "dark blue" e "light green". Por predefinição, o Ad Manager adiciona [%Color%] ao fragmento do modelo de criativo:
<a href="https://paint.com/wall.html?color=[%Color%]">Pinte!</a>
Quando o criativo é criado, o Ad Manager substitui [%Color%] pela string de texto literal do item de lista selecionado. Neste exemplo, as strings de texto literal contêm carateres de espaço e vão quebrar o URL, uma vez que os carateres de espaço têm de ser codificados. Utilize [%URI_ENCODE:Color%] para evitar este problema.
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Pinte!</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
Esta macro é útil sobretudo quando utilizar uma variável de modelo de criativo para definir um URL de clique ou um URL de redirecionamento. Sem uma codificação correta, o URL completo no criativo pode não funcionar.
Exemplo
Por exemplo, um modelo de criativo tem uma variável de "URL" denominada "LandingPage". Por predefinição, o Ad Manager adiciona [%LandingPage%] ao fragmento do modelo de criativo:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Clique aqui!</a>
Se o URL [%LandingPage%] tiver parâmetros de consulta, como ?page=home&sport=baseball, o URL fica formatado incorretamente e o redirecionamento não funciona como deveria. Neste exemplo, o conteúdo após o E comercial (&) é atribuído ao URL completo e não ao URL de redirecionamento. Utilize [%URI_ENCODE:LandingPage%] para evitar este problema.
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Clique aqui!</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Macros de acompanhamento
Estas macros são utilizadas sobretudo para relatórios e acompanhamento.
Ignore a cache (número aleatório)| Macro |
|---|
%%CACHEBUSTER%% |
A macro para ignorar a cache garante que é efetuada uma nova chamada para o servidor de anúncios sempre que é executado o código para que o utilizador consiga contar impressões com precisão. Se não adicionar a macro para ignorar a cache ao código de criativo, o mais provável é que se depare com discrepâncias na contagem de impressões entre o Google Ad Manager e um servidor de anúncios de terceiros. Tenha em atenção que nem todos os anunciantes de terceiros necessitam da macro para ignorar a cache.
A maioria dos fornecedores de criativos disponibiliza um marcador de posição nas respetivas etiquetas, para inserção de macros para ignorar a cache. Por exemplo, se o seu código de criativo de terceiros for semelhante a este:
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]
Deve selecionar [RANDOM_NUMBER] e clicar em Inserir macro para ignorar a cache para substituir o marcador de posição:
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER para reduzir as discrepâncias quando utilizar o acompanhamento de impressões do Campaign Manager 360 para o Ad Manager.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
Macros para ignorar a cache em respostas VAST
A macro %%CACHEBUSTER%% expande-se para o mesmo número aleatório para todos os eventos num determinado criativo. Isto é particularmente útil para anúncios de vídeo, uma vez que a macro se expande para o mesmo número aleatório para todos os eventos de acompanhamento de vídeo numa resposta VAST.
| Macro | Carateres de escape |
|---|---|
%%CLICK_URL_UNESC%% |
Sem caráter de escape |
%%CLICK_URL_ESC%% |
Com caráter de escape |
%%CLICK_URL_ESC_ESC%% |
Com carateres de escape duplo |
A macro de clique expande-se para um URL especial para poder acompanhar os cliques de criativos de terceiros no Ad Manager. Normalmente, esta macro está sincronizada com o URL de clique de um criativo na etiqueta âncora (<a>). Não introduza a macro de clique como origem de uma imagem ou de um iFrame. Caso contrário, faz com que um clique seja registado sempre que a imagem ou o iFrame forem convertidos, o que não é legítimo e é filtrado como um clique inválido.
Utilize %%CLICK_URL_UNESC%% no início de um link. Utilize %%CLICK_URL_ESC%% quando o acompanhamento 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 acerca das macros com e sem caráter de escape.
Valide a implementação de macros de clique
Uma macro de clique colocada incorretamente não acompanha os cliques. Siga estes passos para confirmar que o Ad Manager irá registar os cliques como pretende.
- Pré-visualize o criativo.
- Clique na pré-visualização.
O Ad Manager apresenta uma confirmação de que os cliques serão registados. Se não vir esta confirmação, a macro de clique não está implementada corretamente.
| Macro | Para o que permite expandir |
|---|---|
%eaid! |
ID do elemento publicitário |
%eadv! |
ID do anunciante para o elemento publicitário a ser publicado |
%ebuy! |
ID de encomenda do elemento publicitário a ser publicado |
%ecid! |
ID do criativo |
%eenv! |
Indicador de ambiente (tipo de etiqueta): i para iframe, j para JavaScript |
%epid! |
ID do bloco de anúncios onde o elemento publicitário está a ser publicado |
%esid! |
ID do bloco de anúncios de nível mais elevado acima do bloco de anúncios em que o elemento publicitário está a ser publicado.
Esta é uma macro antiga e pode não funcionar como esperado com a sua rede.
|
Utilize as macros de expansão no código de criativo personalizado ou num URL de clique para apresentar os valores de ID do Ad Manager quando publicar criativos numa página. Isto é frequentemente utilizado para fazer corresponder os IDs do Ad Manager aos IDs na própria base de dados de um publicador para a resolução de problemas ou outros relatórios.
As macros de expansão podem ser separadas umas das outras no URL de clique com qualquer caráter que seja seguro para utilização nos URLs de clique do Ad Manager. Por exemplo, http://www.site.com/?%eaid!;%ecid! expande-se para http://www.site.com/?1234567;4265598.
| Macro |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (o identificador de dispositivo) |
%%ADVERTISING_IDENTIFIER_TYPE%% (o tipo de dispositivo) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (a definição Limitar o acompanhamento de anúncios) |
A macro %%ADVERTISING_IDENTIFIER_PLAIN%% permite que os publicadores na app enviem um ID do dispositivo reajustável aos parceiros de publicidade com vista à publicação de anúncios com base em interesses. Deste modo, é mais fácil conceder acesso ao ID do dispositivo reajustável aos seus anunciantes e agências.
Os publicadores na app também podem utilizar a macro %%ADVERTISING_IDENTIFIER_TYPE%% para enviar o tipo de dispositivo e a macro %%ADVERTISING_IDENTIFIER_IS_LAT%% para enviar a definição Limitar o acompanhamento de anúncios (LAT), que indica o sinal Limitar acompanhamento de anúncios de um dispositivo.
Saiba mais acerca dos IDs de dispositivos reajustáveis para a segmentação de utilizadores, que incluem os tipos de dispositivos suportados.
Pré-requisitos
Defina a encriptação de HTTPS para criativos. Este é um requisito tanto para o criativo como para quaisquer píxeis de terceiros que utiliza para o acompanhamento de conversões. Se os criativos não forem encriptados para HTTPS ou se substituir a compatibilidade automática com SSL, a macro não expande o valor, mas os criativos ainda são publicados.
Como funciona
- No Ad Manager, o publicador inclui as macros no criativo e/ou nos URLs de acompanhamento.
-
As macros expandem-se para ter o ID do dispositivo do utilizador, o tipo de dispositivo e/ou a definição LAT, que são depois incluídos no criativo quando fazem chamadas para terceiros.
A macro de identificador não se expande se o pedido de anúncio for proveniente de uma app dirigida a crianças (TFCD) ou se a definição Limitar o acompanhamento de anúncios (LAT) estiver ativada. Nestes casos, esta macro devolve uma string vazia ("").
Formato
Esta macro envia 32 dígitos hexadecimais em maiúsculas, apresentados em cinco grupos e separados por hífenes, sob a forma 8-4-4-4-12 para um total de 36 carateres (32 carateres alfanuméricos e quatro hífenes).
Exemplo: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Consulte os valores possíveis para os tipos de dispositivos suportados e a definição Limitar o acompanhamento de anúncios (LAT).
| Macro |
|---|
%%PREVIEW_MODE%% |
Utilize a macro de modo de pré-visualização em códigos de criativos personalizados para evitar que os seus sistemas de back-end ou de terceiros contem impressões de pré-visualização. A macro expande-se para true se o criativo estiver a ser visualizado como uma pré-visualização do Ad Manager e para false se for uma impressão normal.
| Macro |
|---|
%%SCHEME%% |
A macro de esquema expande-se para http: ou https: consoante o esquema de segurança da página Web onde o criativo está a ser publicado. É 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 numa etiqueta de anúncio (por exemplo, google.com). É possível utilizar a macro para modificar o criativo com base na origem do pedido. Não funciona em anúncios do Ad Exchange marcados como anónimos.
| Macro | Carateres de escape |
|---|---|
%%VIEW_URL_ESC%% |
Com caráter de escape |
%%VIEW_URL_UNESC%% |
Sem caráter de escape |
A macro de impressão visualizada permite que o Ad Manager contabilize uma impressão sempre que um criativo é transferido no dispositivo do utilizador e o respetivo carregamento é iniciado. Utilize esta macro apenas em criativos fora da página.
Há várias formas de enviar um ping de visualização. Recomendamos a utilização de uma etiqueta <img>:
<!-- Esta etiqueta img é invisível. Faz com que o navegador envie um pedido para o VIEW_URL. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">
<!-- Esta etiqueta img mostra o anúncio real.-->
<img src="[%Imagefile%]" border="0">
A primeira etiqueta <img> devolve uma imagem 1 x 1 a partir do VIEW_URL. Defina o estilo como "display:none" para que fique oculta e não afete o esquema da página.
Macros de pedidos de anúncios para o RGPD
Estas macros são utilizadas sobretudo com pedidos de anúncios sujeitos ao RGPD.
RGPD| Macro |
|---|
${GDPR} |
Expande-se para o valor de gdpr= associado ao pedido.
| Macro |
|---|
${GDPR_CONSENT_XXXX} |
Expande-se para a string de Transparência e Consentimento (TC) associada ao pedido. Se a string de Transparência e Consentimento (TC) estiver em branco ou for inválida, esta macro não se expande. Utilize esta macro para transmitir a string de TC para um fornecedor de criativos de terceiros num URL em criativos não programáticos.
Substitua "XXXX" pelo ID de GVL do IAB do fornecedor de terceiros. Se a string de TC estiver em branco ou for inválida, esta macro não se expande.
Os criativos com a macro ${GDPR_CONSENT_XXXX} podem ficar bloqueados se o fornecedor de terceiros associado ao ID de GVL do IAB que introduziu não tiver o consentimento do utilizador.
Quando é utilizada numa etiqueta VAST e o fornecedor de terceiros não tem consentimento do utilizador, esta macro não se expande.
A macro ${GDPR_CONSENT_XXXX} só deve aparecer uma vez no URL. Contactar o seu fornecedor de criativos de terceiros para compreender os respetivos requisitos sobre a transmissão da string de TC e as restrições de comprimento do URL. A macro é substituída em pedidos da TCF v2.0 do IAB relevantes 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. Apenas os criativos de redirecionamento de display e de display personalizados suportam a expansão de macros da TCF através dos campos "URL de terceiros" e "Código HTML", respetivamente.
| Macro |
|---|
${ADDTL_CONSENT} |
Expande-se para a string de Consentimento Adicional (AC) associada ao pedido.
| Macro |
|---|
%%TFUA%% |
Expande-se para o valor de 1 para etiquetar o pedido de utilizadores no EEE e no Reino Unido com idade inferior à idade de consentimento.
Macros de vídeo
Estas macros são utilizadas frequentemente em criativos de vídeo para incluir detalhes sobre o contexto ou o conteúdo.
Duração do anúncio de vídeo em milissegundos| Macro |
|---|
%%VIDEO_AD_DURATION%% |
Expande-se para a duração do anúncio de vídeo em milissegundos. Para redirecionamentos/Wrappers VAST, a macro expande-se para a duração declarada do anúncio no Ad Manager.
| Macro | Carateres de escape |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Sem caráter de escape |
%%DESCRIPTION_URL_ESC%% |
Com caráter de escape |
%%DESCRIPTION_URL_ESC_ESC%% |
Com carateres de escape duplo |
Utilize %%DESCRIPTION_URL_ESC%% (com um único caráter de escape) quando a macro está dentro de um URL e %%DESCRIPTION_URL_UNESC%% (sem carateres de escape) noutros contextos. Saber mais acerca das macros com caráter de escape versus sem caráter de escape
Nas etiquetas de anúncios de redirecionamento, estas macros expandem-se para o parâmetro de URL de descrição a partir do parâmetro de consulta description_url da Etiqueta do Publicador Google original. O URL de descrição deverá ser normalmente o mesmo que o URL do referenciador. Deve especificar o description_url na Etiqueta do Publicador Google se houver incorporações onde o SDK para IMA pode não detetar com precisão o URL da página ou se estiver a utilizar vídeo no Ad Exchange ou AdSense para vídeo.
%%DESCRIPTION_URL%%, que faz o mesmo que %%DESCRIPTION_URL_UNESC%%, pelo que não há necessidade de recodificar criativos e modelos mais antigos.| Macro | Carateres de escape |
|---|---|
%%REFERRER_URL_UNESC%% |
Sem caráter de escape |
%%REFERRER_URL_ESC%% |
Com um único caráter de escape |
%%REFERRER_URL_ESC_ESC%% |
Com carateres de escape duplo |
Utilize %%REFERRER_URL_ESC%% (com um único caráter de escape) quando a macro está dentro de um URL e %%REFERRER_URL_UNESC%% (sem carateres de escape) noutros contextos. Saber mais acerca das macros de URL com caráter de escape versus sem caráter de escape
Esta macro expande-se para o URL do referenciador (o URL da página onde o leitor de vídeo está localizado) em etiquetas do anúncio de redirecionamento. Isto é efetuado da seguinte forma: o Ad Manager analisa o parâmetro de consulta do URL da etiqueta do anúncio, isola o URL do referenciador e substitui o texto da macro por esse URL. Funciona apenas com o SDK para IMA da Google, com as seguintes qualificações:
- Tem de ativar o acesso do script na página para esta macro funcionar.
- A macro não funciona dentro de um iFrame.
%%REFERRER_URL%%, que faz o mesmo que %%REFERRER_URL_UNESC%%, pelo que não há necessidade de recodificar anúncios e modelos mais antigos.Macros de conteúdo de vídeo
Estas macros são utilizadas para anúncios que segmentam fontes de conteúdo de vídeo.
| Macro |
|---|
%%VIDEO_DURATION%% |
Expande-se para a duração do vídeo em milissegundos.
| Macro |
|---|
%%VIDEO_ID%% |
Expande-se para o ID do conteúdo de vídeo atualmente em reprodução, que é o ID exclusivo no CMS ou o valor dfpvideo:ContentID do MRSS.
| Macro |
|---|
%%VIDEO_METADATA:key%% |
Expande-se para metadados acerca do vídeo em que o criativo está a ser publicado, com base em chaves-valores associados ao conteúdo do vídeo. As chaves-valor são configuradas no Ad Manager no separador "Vídeo".
Após a segmentação de uma chave de metadados de vídeo, esta pode ser expandida pela macro de metadados de vídeo. A "chave" utilizada na macro deve conter carateres alfanuméricos ou o caráter de sublinhado (_).
| Macro | Carateres de escape |
|---|---|
%%VIDEO_TITLE%% |
Com um único caráter de escape |
A macro de título de vídeo expande-se para apresentar o título de um vídeo conforme definido no Ad Manager.
É necessário um carregamento de conteúdos para esta macro funcionar.
| Macro |
|---|
%%FW_CAID%% |
Expande-se para o ID de anúncio personalizado do FreeWheel.
Esta macro aplica-se apenas aos publicadores que utilizam o FreeWheel para a publicação de anúncios de vídeo.
| Macro |
|---|
%%IAB_CATEGORIES%% |
Utilizada para transmitir categorias de anúncios para criativos classificados manualmente com etiquetas. Esta macro devolve uma lista separada por vírgulas das categorias do IAB padrão aplicáveis (convertidas das categorias classificadas da Google).
Esta macro pode ser utilizada por publicadores que partilham inventário de vídeo com o FreeWheel e pretendem transmitir categorias de anúncios como parâmetros personalizados. Por exemplo, pode adicionar &iab_categories=%%IAB_CATEGORIES%% à sua etiqueta de redirecionamento VAST.