Macros

Las macros son cadenas especiales que se incluyen en el código de las creatividades. Posteriormente, Ad Manager sustituye estas cadenas por otro valor o código según la configuración de la creatividad. Las macros resultan útiles porque le permiten hacer cambios en la creatividad sin tener que editar código; basta con actualizar los elementos a los que las macros hacen referencia.

Hemos incluido recomendaciones sobre cómo usar cada macro, pero puede utilizarlas del modo que más le convenga. Se pueden incluir en cualquier código que se procese en el servidor de anuncios durante la entrega: códigos de creatividades personalizadas o de terceros, códigos de Studio, URLs de destino o etiquetas de anuncios.

Notas importantes sobre las macros

  • Distinción entre mayúsculas y minúsculas
    Las macros distinguen entre mayúsculas y minúsculas. Es decir, debe escribir %%CACHEBUSTER%%, no %%Cachebuster%%.
     
  • Expansión sin escape y con escape
    Las versiones de macros sin escape y con escape se expanden de manera diferente. Consulte más información sobre cómo utilizar macros con escape y sin escape.
  • Inserción de macros
    Si se reconocen los terceros en Ad Manager, se insertan macros automáticamente en las creatividades de terceros o en las URL de etiquetas VAST. Sin embargo, en el caso de las creatividades personalizadas y las plantillas de creatividades, se deben añadir las macros manualmente. Si tiene dudas sobre dónde colocar una macro, póngase en contacto con su proveedor de creatividades.
     
  • Caracteres reservados y codificación de URLs (codificación porcentual)
    Ad Manager reserva algunas letras en minúsculas precedidas de un porcentaje:

%a
%c
%h
%i
%n
%p
%k

Estas cadenas no se deben utilizar en la codificación de la URL, ya que pueden interferir con la expansión de macros.
 

Macros de renderizado

Estas macros se utilizan habitualmente para renderizar creatividades de forma que se muestren y funcionen correctamente.

Bloque de anuncios
 
Macro
%%ADUNIT%%
 

La macro de bloque de anuncios inserta la ruta del bloque de anuncios de su etiqueta Google Publisher Tag en el código de la creatividad cuando se sirve.

A continuación, le indicamos cómo añadir la macro ADUNIT a un fragmento de código de creatividad de terceros:

<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>

La macro de bloque de anuncios se expande a la ruta completa del bloque de anuncios que contiene la solicitud de anuncio original, incluido el código de red. Ejemplo de cómo se expande una ruta de bloque de anuncios cuando se sirve un anuncio:

<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 solo funciona en los bloques de anuncios sugeridos que se hayan aprobado. Si el bloque de anuncios sugerido está en el tercer nivel, la macro solo se expandirá al bloque de anuncios del segundo nivel cuando se use en el fragmento de creatividad. Cuando se haya aprobado el bloque de anuncios sugerido, la macro se expandirá al tercer nivel de bloques de anuncios en el fragmento de la creatividad.

Solo disponible en Google Ad Manager 360.

URL de destino
 
Macro Escape
%%DEST_URL_ESC%% Con formato de escape
%%DEST_URL_ESC_ESC%% Con formato de doble escape
%%DEST_URL_UNESC%% Sin formato de escape
 

La macro de URL de destino se expande a la URL de destino de la creatividad, que es la URL de destino de la línea de pedido o un conjunto de anulaciones para la creatividad que se encuentra en la línea de pedido.

La macro de URL de destino es útil en creatividades personalizadas y plantillas de creatividad. Si el código de creatividad debe incluir la URL de destino de la creatividad y esta cambia a medida que la creatividad o la plantilla se utilizan en distintas líneas de pedido, esta macro podrá ayudar.

Existen tres macros de URL de destino: con formato de escape, con formato de doble escape y sin formato de escape. Normalmente, la cantidad de escapes (es decir, si incluye ESC una o dos veces, o si no lo incluye) depende de la empresa de seguimiento de clics de terceros. Algunas de estas empresas requieren una URL con formato de escape mientras que otras, no. El nivel de escape que requieren las empresas de seguimiento de clics de terceros suele indicarse en la etiqueta con la cadena click= de la etiqueta de anuncio de terceros o en el código de creatividad personalizado de Ad Manager:

  • click=: un solo escape (%%DEST_URL_ESC%%).

  • click0=: sin escape (%%DEST_URL_UNESC%%).

  • click1=: un solo escape (%%DEST_URL_ESC%%).

  • click2=: dos escapes (%%DEST_URL_ESC_ESC%%).

En Ad Manager también se admite %%DEST_URL%%, que tiene la misma función que %%DEST_URL_ESC%%. Le recomendamos que utilice %%DEST_URL_ESC%% porque resulta más clara, pero no es necesario que vuelva a codificar creatividades ni plantillas antiguas.

Servidor de archivos
 
Macro
%%FILE:file_display_name%%
 

La macro de servidor de archivos %%FILE:file_display_name%% se expande a la URL completa de un recurso de creatividad que se haya subido. Utilícela para llamar a recursos subidos, como imágenes, que tengan código de creatividad personalizado.

Para usar esta macro, sustituya file_display_name por el nombre del recurso de la creatividad que se muestra en Ad Manager cuando consulta sus datos.

Alto y ancho
 
Macro
%%HEIGHT%%
%%WIDTH%%
 

Estas macros insertan la altura y la anchura de la creatividad, según el valor del campo "Tamaño del bloque de anuncios de destino" de la creatividad de Ad Manager, en el código personalizado de una creatividad durante el servicio de anuncios.

Las macros de altura y de anchura pueden resultar especialmente útiles si crea una plantilla de creatividad que quiere poder utilizar para creatividades de diversos tamaños. En lugar de codificar el tamaño de cada creatividad, puede dejar que las macros de altura y de anchura inserten los valores en cada creatividad de forma dinámica.

Concordancia de patrones
 
Macro
%%PATTERN:key%%
%%PATTERN:TARGETINGMAP%%
%%PATTERN:url%%
 

Use la macro de concordancia de patrones para transferir a una creatividad una o varias variables personalizadas, como valores de segmentación. Con esta macro, puede transferir pares clave-valor, sustituir toda la cadena de segmentación o expandir la URL referente. Esto puede serle útil si quiere servir distintas creatividades en función de los datos que tenga sobre un usuario (por ejemplo, los contenidos que prefiere).

La macro de concordancia de patrones solo puede hacer 100 sustituciones por creatividad.

Utilizar caracteres de escape con la macro de concordancia de patrones

La macro de concordancia de patrones devuelve el valor tal como lo recibe. Si se utiliza la macro en uno de los campos de URL, como "URL de etiqueta VAST" o "URL de seguimiento de terceros" en una creatividad de vídeo, es posible que desee que el valor mostrado se devuelva con caracteres de escape. Para ello, debe aplicar un triple escape en el valor de la solicitud.

%%PATTERN:key%%

Por ejemplo, puede tener dos creatividades para una línea de pedido determinada: una diseñada para atraer a las usuarias (mujeres) y otra para atraer a los usuarios (hombres). La "clave" utilizada en la macro debe estar formada por caracteres alfanuméricos o por el guion bajo (_).

El proceso es el siguiente:

  1. Está transfiriendo el valor personalizado (en este caso, el sexo del usuario) a una etiqueta de anuncio de su página mediante pares clave-valor, tal como se indica a continuación:
    googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
    .addService(googletag.pubads())
    .setTargeting("gender", "male");
  2. En la creatividad personalizada o de terceros, transfiera dinámicamente el valor personalizado (el sexo del usuario) mediante la siguiente macro: <some creative script here>...&gender=%%PATTERN:gender%%
  3. La macro completa %%PATTERN:gender%% se sustituirá por "male" (hombre).
  4. Ad Manager llamará al archivo de creatividad “male” (hombre) y lo servirá para ese usuario.

%%PATTERN:TARGETINGMAP%%

Con %%PATTERN:TARGETINGMAP%%, puede sustituir toda la asignación de segmentación y crear etiquetas de passback de forma dinámica.

A continuación, le indicamos cómo añadir la macro TARGETINGMAP a una etiqueta de anuncio:

.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();

Ejemplo de la cadena de clave-valor completa cuando el anuncio se publica:

.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();

  Ejemplo de etiqueta de passback entre dos redes de Ad Manager

Con esta macro, se puede configurar una etiqueta de passback entre dos redes de Ad Manager ("Red A" y "Red B").

Ejemplo de creatividad registrada en la Red A de 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>

Si la Red B de Ad Manager no tuviera ninguna campaña vendida que servir, puede devolver la impresión a la Red A mediante una creatividad de passback como la siguiente:

<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
 .definePassback('%%PATTERN:myAdUnit%%', [468, 60])
 .updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
 .setTargeting("kwd", "noloop") // para evitar bucles infinitos
 .display();
</script>
Ejemplo de etiqueta de passback entre Ad Manager y un servidor de anuncios de terceros

También puede utilizar TARGETINGMAP en etiquetas de passback que se envíen en solicitudes a servidores de anuncios de terceros; de este modo, puede tener varios valores en las creatividades dinámicas.

Ejemplo de una creatividad registrada en 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>

Cuando Ad Manager la sirve, se expande a lo que se indica a continuación:

<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>

El servidor de terceros ahora tiene acceso a los parámetros generados de forma dinámica dfpAdUnit y targeting, y puede crear el siguiente 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") // para saber cómo evitar bucles infinitos, consulte el artículo https://support.google.com/admanager/answer/2811375
 .updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>

Para crearlo, es posible que el servidor de terceros reciba un código de plantilla similar 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%%

También puede utilizar la clave reservada url para que la macro se expanda a la URL de la página de referencia.

Tenga en cuenta que url es una clave reservada, por lo que todos los pares clave-valor que tengan el nombre de clave url y estén en sus etiquetas de Campaign Manager 360 se sobrescribirán con la URL referente.

Destino en nueva ventana
 
Macro
%%TARGET_IN_NEW_WINDOW%%
 

La macro de destino en nueva ventana indica si la configuración de la ventana de destino establecida para el bloque de anuncios donde se publica una creatividad es "_blank" (nueva ventana) u otra.

  • Si la ventana de destino es _blank, la macro se expande a 1.

  • Si la ventana de destino tiene cualquier otro valor, o si no se indica ninguna ventana de destino, la macro se expande a 0.

Para insertar el valor real del ajuste de la ventana de destino, utilice la macro %%TARGET_WINDOW%%.

Ventana de destino
 
Macro
%%TARGET_WINDOW%%
 

La macro de ventana de destino se expande a la ventana de destino especificada para el bloque de anuncios en el que se publica el anuncio. Puede insertar la macro dentro del código de una creatividad para especificar si, al hacer clic en la creatividad, se redirigirá al usuario a una nueva ventana o se cargará la página de destino en la misma ventana, en función de la configuración de cada sitio en que los usuarios verán el anuncio.

Por ejemplo, la ventana de destino del bloque de anuncios AdManager_News.com es _top, y la del bloque de anuncios AdManager_Fashion.com, _new. Si se incluye la macro %%TARGET_WINDOW%% en el código de una creatividad, se expandirá a _top cuando la creatividad se muestre a usuarios de AdManager_News.com y a _new al publicarse a usuarios de AdManager_Fashion.com.

A continuación, se muestra una implementación de ejemplo:

<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="mi anuncio"></a>

Para averiguar si el ajuste de la ventana de destino es "_blank" u otro valor, utilice la macro %%TARGET_IN_NEW_WINDOW%%.

Etiqueta de contenido dirigido a niños
 
Macro
%%TFCD%%
 

La etiqueta de contenido dirigido a niños (TFCD) le permite informar a los terceros de que una solicitud de anuncio determinada proviene de una página con contenido dirigido a niños. Con esta macro, se facilita cumplir la ley de protección de la privacidad infantil online (Children's Online Privacy Protection Act, COPPA) de EE. UU.

Puede incluir la macro en todas las redirecciones o solicitudes de creatividades de terceros, con el formato coppa=%%TFCD%% o con otro similar. También se puede utilizar en JavaScript para etiquetar solicitudes de anuncio como contenido dirigido a niños. En función de la información sobre la naturaleza de la página, el sitio web o la aplicación móvil que haya enviado la solicitud a Ad Manager, la macro se expandirá a 1, si se trata de contenido dirigido a niños, o a 0, si es otro tipo de contenido.

Si utiliza los servicios publicitarios de Google y quiere etiquetar sitios web o aplicaciones como contenido dirigido a niños, consulte el artículo Etiquetar un sitio web o una solicitud de anuncio como contenido dirigido a niños.

Codificación de URI para plantillas de creatividades
 
Macro
[%URI_ENCODE:variable%]
 

Con la macro de codificación de URI, se traducen correctamente los espacios y otros caracteres especiales de los valores de variables de plantillas de creatividades para que puedan utilizarse en URIs, también denominadas URLs.

Esta macro solo funciona con plantillas de creatividades, no con creatividades de terceros ni personalizadas, y no aplica doble codificación a los caracteres que ya han sido codificados.

Ejemplo

Supongamos que su plantilla de creatividad tiene una variable "list" llamada "Color" con dos valores: "azul oscuro" y "verde claro". De forma predeterminada, Ad Manager añade [%Color%] al fragmento de la plantilla de creatividad:

<a href="https://paint.com/wall.html?color=[%Color%]">A pintar</a>

Cuando se genera la creatividad, se sustituye [%Color%] por la cadena de texto literal de la línea de pedido que se haya seleccionado. En este ejemplo, las cadenas de texto literal contienen caracteres de espacio e interrumpirán la URL, ya que los caracteres de espacio deben codificarse. Para evitar este problema, utilice [%URI_ENCODE:Color%].

<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">A pintar</a>
 

[%Color%] azul oscuro
[%URI_ENCODE:Color%] azul%20oscuro

Esta macro es especialmente útil cuando se utiliza una variable de plantilla de creatividad para definir una URL de redirección o una URL de destino. Si la codificación no es correcta, es posible que la dirección URL completa de la creatividad no funcione.

Ejemplo

Supongamos que su plantilla de creatividad tiene una variable "URL" llamada "LandingPage". De forma predeterminada, Ad Manager añade [%LandingPage%] al fragmento de la plantilla de creatividad:

<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Haga clic aquí</a>

Si en la URL que se indica en [%LandingPage%] se incluyen parámetros de consulta, como ?page=home&sport=baseball, la URL no se formará correctamente ni la redirección funcionará como debería. En este ejemplo, el contenido después del ampersand (&) se atribuirá a la URL completa y no a la de redirección. Para evitar este problema, utilice [%URI_ENCODE:LandingPage%].

<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Haga clic aquí</a>
 

[%LandingPage%] https://www.mysportswebsite.com?
page=home&sport=baseball
[%URI_ENCODE:LandingPage%] https%3A%2F%2Fwww.mysportswebsite.com%3F
page%3Dhome%26sport%3Dbaseball

Macros de seguimiento

Estas macros suelen utilizarse para hacer seguimientos y generar informes.

Cachebuster (número aleatorio)
 
Macro
%%CACHEBUSTER%%
 

La macro cachebuster garantiza que se realice una nueva llamada al servidor de anuncios cada vez que se ejecuta el código, por lo que las impresiones se pueden contar con precisión. Si no añade la macro cachebuster al código de la creatividad, es más probable que vea discrepancias en los recuentos de impresiones entre Google Ad Manager y un servidor de anuncios de terceros. Tenga en cuenta que no todos los servidores de terceros requieren la macro cachebuster.

La mayoría de los proveedores de creatividades ofrecen un marcador de posición en la etiqueta con el objetivo de insertar estas macros. Por ejemplo, si su código de la creatividad de terceros contiene una etiqueta como esta:

http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]

Tendrá que seleccionar [RANDOM_NUMBER] y hacer clic en Insertar macro cachebuster para sustituir el marcador de posición, tal como se indica a continuación:

http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%

Seleccione una etiqueta de anuncio estándar e inserte la macro CACHEBUSTER para reducir las discrepancias que se producen al utilizar el registrador de impresiones de Campaign Manager 360 en Ad Manager.

http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?

Las macros cachebuster en respuestas de VAST

La macro %%CACHEBUSTER%% se expande al mismo número aleatorio en todos los eventos de una creatividad concreta. Esto resulta especialmente útil en anuncios de vídeo, puesto que en la macro se añadirá el mismo número aleatorio con cada evento de seguimiento de vídeo de una respuesta de VAST.

Clic
 
Macro Escape
%%CLICK_URL_UNESC%% Sin formato de escape
%%CLICK_URL_ESC%% Con formato de escape
%%CLICK_URL_ESC_ESC%% Con formato de doble escape
 

La macro de clics se expande a una URL especial para que pueda hacer el seguimiento de clics de creatividades de terceros en Ad Manager. Esta macro se vincula normalmente con la URL de destino de una creatividad en la etiqueta de enlace (<a>). No introduzca la macro de clics como origen de una imagen o de un iframe. Si lo hace, se registrará un clic cada vez que se renderice la imagen o el iframe, lo que no sería legítimo, y se excluirá por ser un clic no válido. 

Utilice %%CLICK_URL_UNESC%% al principio de un enlace. Use %%CLICK_URL_ESC%% cuando el registrador de clics sea el parámetro de otra URL.

<a href="%%CLICK_URL_UNESC%%http://www.google.com">enlace</a>

<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">enlace</a>

Más información sobre las macros con escape y las macros sin escape

Verificar la implementación de macros de clics

Una macro de clics que no esté colocada correctamente no hará un seguimiento de los clics. Siga estos pasos para confirmar que Ad Manager registrará los clics según lo previsto.

  1. Obtenga una vista previa de la creatividad.
  2. Haga clic en la vista previa.

Ad Manager muestra una confirmación de la grabación de los clics. Si no ve esta confirmación, la macro de clics no se ha implementado correctamente.

Expansión
 
Macro A qué se expande
%eaid! Al ID de línea de pedido
%eadv! Al ID de anunciante para la línea de pedido que se publica
%ebuy! Al ID de pedido para la línea de pedido que se publica
%ecid! Al ID de creatividad
%eenv! Al indicador de entorno (tipo de etiqueta): i en iframes, j en JavaScript
%epid! Al ID del bloque de anuncios en el que se publica la línea de pedido
%esid! Al ID del bloque de anuncios de mayor nivel que se encuentre por encima de aquel en que la línea de pedido sirve anuncios

Se trata de una macro antigua y es posible que en su red no funcione como estaba previsto.

 

Utilice macros de expansión en el código de la creatividad personalizada o en una URL de destino para visualizar los valores de ID de Ad Manager cuando se sirve una creatividad a una página. A menudo, esta macro se usa para asociar IDs de Ad Manager con IDs de la base de datos de editores y, así, solucionar problemas o generar informes.

Las macros de expansión se pueden separar unas de otras en las URL de destino mediante cualquier carácter que se pueda usar en dichas URL de Ad Manager. Por ejemplo, http://www.site.com/?%eaid!;%ecid! se expande a http://www.site.com/?1234567;4265598.

ID de dispositivo (iOS, Android, Roku y tvOS)
 
Macro
%%ADVERTISING_IDENTIFIER_PLAIN%% (identificador de dispositivo)
%%ADVERTISING_IDENTIFIER_TYPE%% (tipo de dispositivo)
%%ADVERTISING_IDENTIFIER_IS_LAT%% (ajuste para limitar el seguimiento de anuncios)
 

Con la macro %%ADVERTISING_IDENTIFIER_PLAIN%%, los editores de anuncios en aplicaciones pueden enviar IDs de publicidad para móviles reajustables (IDFA en iOS, AdID en Android, RIDA en Roku y tvOS en Apple TV) a sus partners de publicidad para publicar anuncios basados en intereses. De este modo, puede permitir fácilmente que sus anunciantes y agencias accedan a los ID de publicidad móvil.

Los editores de anuncios en aplicaciones móviles también pueden utilizar la macro %%ADVERTISING_IDENTIFIER_TYPE%% para enviar el tipo de dispositivo, y la macro %%ADVERTISING_IDENTIFIER_IS_LAT%% para enviar el ajuste Limitar el seguimiento de anuncios (LAT), con el que los usuarios pueden inhabilitar la segmentación en función de su comportamiento.

Más información sobre los ID de dispositivo que se pueden cambiar para emplearlos en la segmentación de usuarios

Requisitos

  • Utilizar la versión del SDK de anuncios de Google para móviles más reciente en su aplicación móvil.
  • Configurar el cifrado HTTPS en creatividades. Se trata de un requisito tanto para la creatividad como para los píxeles de terceros que utilice para hacer el seguimiento de conversiones. Si las creatividades no están cifradas para HTTPS, no se mostrará el valor IDFA/AdID/RIDA/tvOS en la macro, pero estas seguirán publicándose.

Cómo funciona

  1. En Ad Manager, los editores añaden las macros en las creatividades o en las URL de seguimiento.
  2. Las macros se expanden para obtener el IDFA/AdID/RIDA/tvOS del usuario, del tipo de dispositivo o de la configuración LAT y, a continuación, se incluyen en la creatividad mientras hacen llamadas a terceros.

    La macro de identificador no se expande si las solicitudes de anuncios provienen de aplicaciones dirigidas a niños (TFCD) o si se ha activado el ajuste Limitar el seguimiento de anuncios. En esos casos, la macro devuelve una cadena vacía ("").

Formato

En iOS, Android, Roku y tvOS, esta macro envía un valor hexadecimal de 32 dígitos en mayúsculas, que se muestra en cinco grupos separados por guiones, con la estructura 8-4-4-4-12, sumando un total de 36 caracteres (32 caracteres alfanuméricos y cuatro guiones).

Ejemplo: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41

Consulte los valores posibles de los tipos de dispositivos admitidos y del ajuste para limitar el seguimiento de anuncios (LAT).

Modo de vista previa
 
Macro
%%PREVIEW_MODE%%
 

Utilice la macro de modo de vista previa en el código de creatividad personalizado para evitar que los sistemas remotos o de terceros cuenten las impresiones de vista previa. Si una creatividad se muestra como vista previa de Ad Manager; la macro se expande a true. En el caso de que se trate de una impresión normal, se expande a false.

Esquema
 
Macro
%%SCHEME%%
 

La macro de esquema se expande a http: o https:, el protocolo que coincida con el esquema de seguridad de la página web donde se publica la creatividad. Puede colocarla al principio de una URL de la siguiente manera:

<img src=%%SCHEME%%//www.website.com/img/logo.gif>

Sitio
 
Macro
%%SITE%%
 

Se expande al dominio del parámetro de URL de una etiqueta de anuncio (por ejemplo, google.com). Puede utilizarse la macro para modificar su creatividad en función de la procedencia de la solicitud. No funciona en anuncios de Ad Exchange que se marquen como anónimos.

Impresiones vistas
 
Macro Escape
%%VIEW_URL_ESC%% Con formato de escape
%%VIEW_URL_UNESC%% Sin formato de escape
 

Con la macro de impresiones vistas, Ad Manager cuenta una impresión cada vez que se descarga una creatividad en el dispositivo de un usuario y empieza a cargarse. Utilice esta macro solo en creatividades fuera de página.

Hay varias formas de enviar pings de visualización, pero recomendamos usar etiquetas <img>:

<!-- Esta etiqueta img es invisible y hace que los navegadores envíen solicitudes a VIEW_URL. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">

<!-- Esta etiqueta img muestra el anuncio real.-->
<img src="[%Imagefile%]" border="0">

Con la primera etiqueta <img> se obtiene una imagen 1x1 de VIEW_URL. Para que la imagen no se muestre ni afecte al diseño de las páginas, introduzca "display:none" en el estilo.

Macros de vídeo

Estas macros se utilizan habitualmente en creatividades de vídeo para incluir detalles sobre el contexto o el contenido.

URL de descripción de vídeo
 
Macro Escape
%%DESCRIPTION_URL_UNESC%% Sin formato de escape
%%DESCRIPTION_URL_ESC%% Con formato de escape
%%DESCRIPTION_URL_ESC_ESC%% Con formato de doble escape
 

Utilice %%DESCRIPTION_URL_ESC_ESC%% (un solo escape) cuando la macro esté en una URL y %%DESCRIPTION_URL_UNESC%% (sin formato de escape) en otros casos. Más información sobre las diferencias entre las macros con escape y las macros sin escape

En las etiquetas de anuncio de redirección, estas macros se expanden al parámetro de URL de descripción desde el parámetro de consulta description_url original de la etiqueta Google Publisher Tag. Por lo general, las URL de descripción deben ser idénticas a las URL de referencia. Si hay elementos insertados en los que es posible que el SDK de IMA no detecte con precisión la URL de la página, o si utiliza vídeos de Ad Exchange para vídeo o AdSense para vídeo, debe indicar valores description_url en las etiquetas Google Publisher Tag.

En Ad Manager también se admite %%DESCRIPTION_URL%%, que tiene la misma función que %%DESCRIPTION_URL_UNESC%%, por lo que no es necesario volver a generar el código de creatividades ni plantillas antiguas.

URL de referencia de vídeo
 
Macro Escape
%%REFERRER_URL_UNESC%% Sin formato de escape
%%REFERRER_URL_ESC%% Con formato de un solo escape
%%REFERRER_URL_ESC_ESC%% Con formato de doble escape
 

Utilice %%REFERRER_URL_ESC_ESC%% (un solo escape) cuando la macro esté en una URL y %%REFERRER_URL_UNESC%% (sin escape) en otros casos. Más información sobre las diferencias entre las macros con escape y las macros sin escape

En las etiquetas de anuncios de redirección, esta macro se expande a la URL referente (es decir, la página donde está el reproductor de vídeo). Lo hace de la siguiente manera: Ad Manager analiza los parámetros de consulta de URL de una etiqueta de anuncio, aísla la URL referente y sustituye el texto de la macro por esa URL. Funciona solo con el SDK de IMA de Google si se cumplen los siguientes requisitos:

  • Para que esta macro funcione, el acceso a la secuencia de comandos debe activarse en la página.
  • La macro no funcionará si se encuentra dentro de un iframe.

En Ad Manager también se admite %%REFERRER_URL%%, que tiene la misma función que %%REFERRER_URL_UNESC%%, por lo que no es necesario volver a generar el código de creatividades ni de plantillas antiguas.

Macros de contenido de vídeo

Estas macros se utilizan en anuncios dirigidos a fuentes de contenido de vídeo.

Solo disponible en Google Ad Manager 360.

Duración de vídeo (ms)
 
Macro
%%VIDEO_DURATION%%
 

Se expande a la duración del vídeo en milisegundos.

ID de vídeo
 
Macro
%%VIDEO_ID%%
 

Se expande al ID del contenido de vídeo que se esté reproduciendo en ese momento, que puede ser el ID único del CMS o el valor dfpvideo:ContentID de MRSS. 

Metadatos de vídeo
 
Macro
%%VIDEO_METADATA:key%%
 

Se expande a los metadatos del vídeo cuando la creatividad se está publicando, en función de los pares clave-valor asociados al contenido de vídeo. Los pares clave-valor se configuran en la pestaña "Vídeo" de Ad Manager.

La "clave" utilizada en la macro debe estar formada por caracteres alfanuméricos o por el guion bajo (_).

Título de vídeo
 
Macro Escape
%%VIDEO_TITLE%% Con formato de un solo escape
 

La macro de título de vídeo se expande para mostrar el título de un vídeo como se define en Ad Manager.

Para que esta macro funcione, es necesario que se ingiera el contenido.

Solo disponible en Google Ad Manager 360.

ID de anuncio personalizado (FreeWheel)
 
Macro
%%FW_CAID%%
 

Se expande al ID de anuncio personalizado de FreeWheel.

Esta macro solo se aplica a editores que utilizan FreeWheel para servir anuncios de vídeo.

Categorías de IAB (FreeWheel)
 
Macro
%%IAB_CATEGORIES%%
 

Se utiliza para transferir categorías de anuncios en las creatividades que haya clasificado manualmente con las etiquetas. Esta macro devuelve una lista separada por comas de categorías IAB estándares y aplicables que se han creado a partir de categorías clasificadas de Google.

Esta macro la pueden utilizar los editores que comparten inventario de vídeo con FreeWheel y quieren pasar las categorías de anuncio como parámetros personalizados. Por ejemplo, podría añadir &iab_categories=%%IAB_CATEGORIES%% a su etiqueta de redirección de VAST.

Macros de solicitudes de anuncios relacionadas con el RGPD

Estas macros se utilizan más habitualmente con solicitudes de anuncios que están sujetas al RGPD.

RGPD
 
Macro
${GDPR}
 

Se expande al valor de gdpr= asociado a la solicitud.

Cadena de transparencia y consentimiento (TC)
 
Macro
${GDPR_CONSENT_XXXX}
 

Se expande a la cadena de transparencia y consentimiento (TC) asociada a la solicitud. Si la cadena de TC está en blanco o no es válida, esta macro no se expande. Utilice esta macro para enviar la cadena de TC a un proveedor de creatividades externo en una URL de creatividades no programáticas. Sustituya "XXXX" por el ID del proveedor externo que figure en la lista global de proveedores de IAB. Si la cadena de TC está en blanco o no es válida, esta macro no se expandirá.

Puede que las creatividades con la macro ${GDPR_CONSENT_XXXX} se bloqueen si el proveedor externo asociado al ID que figura en la lista global de proveedores de IAB y que ha insertado no tiene el consentimiento de usuario.

La macro ${GDPR_CONSENT_XXXX} solo debe aparecer una vez en las URLs. Pregunte a su proveedor externo de creatividades qué requisitos debe cumplir para enviarle cadenas de TC y qué longitud pueden tener como máximo las URLs. En las solicitudes de la versión 2.0 del TCF de IAB oportunas, la macro se sustituirá por la cadena de TC completa y sin modificar.

Modo de Consentimiento Adicional
 
Macro
${ADDTL_CONSENT}
 

Se expande a la cadena de consentimiento adicional (AC) asociada a la solicitud.

Usuarios del EEE y del Reino Unido que aún no tienen la edad de consentimiento
 
Macro
%%TFUA%%
 

Se expande al valor 1 para etiquetar que la solicitud va dirigida a usuarios del EEE y del Reino Unido que aún no tienen la edad de consentimiento.

Anuncios no personalizados
 
Macro
%%NPA%%
 

Se expande al valor 1 para etiquetar que la solicitud no es personalizada.

La macro de anuncios no personalizados solo se puede utilizar en la inserción dinámica de anuncios. Consulte las macros que se pueden usar en la inserción dinámica de anuncios.

¿Te ha resultado útil esta información?
¿Cómo podemos mejorar esta página?

¿Necesitas más ayuda?

Inicia sesión si quieres ver otras opciones de asistencia para solucionar tu problema.

true
Búsqueda
Borrar búsqueda
Cerrar búsqueda
Aplicaciones de Google
Menú principal
Buscar en el Centro de ayuda
true
148
false