Las macros son strings especiales en el código de la creatividad. Más adelante, Ad Manager reemplazará esta string con otro valor o código según la configuración de la creatividad. Las macros son útiles porque, si necesita realizar cambios, usted no tiene que actualizar el código de la creatividad directamente, sino que puede actualizar la referencia de las macros.
Para cada macro, proporcionamos sugerencias acerca de cómo podría usarla, pero usted puede emplearlas según sus necesidades. Las macros se pueden incluir en cualquier código que procese el servidor de anuncios durante la publicación: código de la creatividad personalizada o de terceros, código de Studio, URL de clic o etiquetas de anuncios.
Notas importantes acerca de las macros
- Mayúsculas y minúsculas
Las macros distinguen entre mayúsculas y minúsculas. Use%%CACHEBUSTER%%, no%%Cachebuster%%. - Expansión con y sin escape
Las versiones de macros con y sin escape se expanden de manera diferente. Obtenga información sobre cómo usar macros con y sin escape. - Inserción de marcos
Ad Manager inserta macros automáticamente para las creatividades de terceros o URL de etiquetas VAST, siempre que reconozca al tercero. En los casos de las creatividades personalizadas y plantillas de creatividades, debe agregar las macros de forma manual. Si no tiene certeza sobre dónde colocar una macro, comunícate con tu proveedor de creatividades.
Cuando coordines el tráfico con una plantilla de creatividad, solo aparecerá una entrada de URL de clic cuando se use una macro de clics en la plantilla. - Caracteres reservados y codificación de URL (codificación con símbolo de porcentaje)
Ad Manager se reserva el uso de algunas letras minúsculas precedidas por el símbolo de porcentaje:%a
%c
%h
%i
%n
%p
%kEstas strings no deben usarse en la codificación de URL, ya que pueden interferir en la expansión de macros.
- Las macros no son compatibles con Programática directa
Consulte las funciones disponibles para Programática directa.
Avance a una macro específica de la lista
Macros de renderización
Por lo general, este tipo de macro se usa para renderizar creatividades, lo que permite garantizar que se vean bien y funcionen en forma correcta.
Unidad de anuncios| Macro |
|---|
%%ADUNIT%% |
La macro de unidad de anuncios inserta la ruta de la unidad de anuncios de su Google Publisher Tag en el código de la creatividad cuando se publica.
A continuación, se muestra cómo agregar la macro ADUNIT a un fragmento de código de la 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 unidad de anuncios se expande a la ruta de la unidad de anuncios completa que contiene la solicitud de anuncio original, incluido el código de red. A continuación, verá un ejemplo de cómo se expande la ruta de la unidad de anuncios cuando se publica el 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 para unidades de anuncios sugeridas. Si una unidad de anuncios sugerida está en el tercer nivel, la macro solo se expande a la unidad de anuncios del segundo nivel cuando se usa en el fragmento de la creatividad. Una vez aprobada la unidad de anuncios sugerida, la macro se expande al tercer nivel de la unidad de anuncios en el fragmento de la creatividad.
| Macro | Escape |
|---|---|
%%DEST_URL_ESC%% |
Con escape |
%%DEST_URL_ESC_ESC%% |
Con escape doble |
%%DEST_URL_UNESC%% |
Sin escape |
La macro de URL de destino se expande a la URL de clic de la creatividad, que es la URL de clic de la línea de pedido o un conjunto de anulación para la creatividad dentro de la línea de pedido.
La macro de URL de destino es útil en creatividades personalizadas y plantillas de creatividades. Si el código de la creatividad debe incluir la URL de clic de la creatividad, y la URL de clic cambia cuando la creatividad o la plantilla se usa en diferentes líneas de pedido, esta macro puede resultar útil.
Existen tres macros de URL de clic: con escape, con escape doble y sin escape. Generalmente, la cantidad de escapes (si incluye el escape una vez, dos veces o no lo incluye) depende de la empresa de seguimiento de clics de terceros. Algunas empresas de seguimiento de clics de terceros requieren que la URL tenga escape, mientras que otras no. Generalmente, el nivel de escape que necesitan estas empresas se especifica con la string click= en la etiqueta de anuncio de terceros o en el código de la creatividad personalizada en Ad Manager:
-
click=: con un escape (%%DEST_URL_ESC%%) -
click0=: sin escape (%%DEST_URL_UNESC%%). -
click1=: con un escape (%%DEST_URL_ESC%%). -
click2=: con dos escapes (%%DEST_URL_ESC_ESC%%)
%%DEST_URL%%, que cumple la misma función que %%DEST_URL_ESC%%. Se recomienda usar %%DEST_URL_ESC%% para brindar mayor claridad, pero no es necesario volver a codificar creatividades ni plantillas anteriores.%u o %%DEST_URL%%, se lo redireccionará a la URL xsd:string cuando haga clic en la creatividad. Tiene una longitud máxima de 1024 caracteres.| Macro |
|---|
%%FILE:file_display_name%% |
La macro del servidor de archivos %%FILE:file_display_name%% se expande a la URL completa de un elemento que se subió para una creatividad. Use esta macro para realizar llamadas a elementos subidos, como una imagen, con el código de la creatividad personalizada.
Para usar esta macro, reemplaza file_display_name con el nombre visible del recurso de creatividad, como se muestra en Ad Manager cuando consultas los detalles de la creatividad.
| Macro |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Estas macros insertan el alto y el ancho del elemento (tal como se define en Ad Manager en el valor del campo "Tamaño de la unidad de anuncios de segmentación" de la creatividad) en el código personalizado de una creatividad durante el proceso de publicación de anuncios.
Las macros de alto y ancho pueden resultar especialmente útiles si está creando una plantilla de creatividad que quiere volver a usar con elementos de diferentes tamaños. En lugar de codificar el tamaño de cada creatividad, puede dejar que las macros de alto y ancho inserten los valores en cada elemento de forma dinámica.
| Macro |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
Use la macro de coincidencia de patrones para pasar una o más variables personalizadas, como un valor de segmentación, a una creatividad. Puede utilizar esta macro para pasar pares clave-valor, reemplazar toda la cadena de segmentación o expandir la URL de referencia. Esto puede ser útil si desea publicar creatividades diferentes según la información que tiene sobre un usuario, como sus preferencias de contenido.
La macro de coincidencia de patrones tiene un límite de 100 reemplazos por creatividad.
Cómo marcar un escape en la macro de coincidencia de patrones
La macro de coincidencia de patrones muestra el valor como se recibió. Si usa la macro en uno de los campos de URL, como el campo "URL de etiqueta VAST" o "URL de seguimiento de terceros" en una creatividad de video, es posible que quiera que el valor expandido se muestre con escape. Para ello, debe escapar tres veces el valor en la solicitud.
%%PATTERN:key%%
Por ejemplo, tiene dos creatividades para una línea de pedido determinada: una diseñada para atraer a mujeres y otra diseñada para atraer a hombres. La "clave" que se usa en la macro debe escribirse con caracteres alfanuméricos o guion bajo (_).
El proceso funciona de la siguiente manera:
- Estás pasando el valor personalizado (en este caso, el género del usuario) a una etiqueta de anuncio de tu página mediante pares clave-valor:
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - En la creatividad personalizada o de terceros, pasa el valor personalizado (el género del usuario) de forma dinámica mediante la siguiente macro:
<some creative script here>...&gender=%%PATTERN:gender%% - Se reemplazará toda la macro de
%%PATTERN:gender%%con "male". - Ad Manager realizará una llamada y publicará el archivo de creatividad "male" para este usuario.
%%PATTERN:TARGETINGMAP%%
Puede usar %%PATTERN:TARGETINGMAP%% para reemplazar todo el mapa de segmentación y crear dinámicamente etiquetas de devoluciones.
A continuación, se muestra cómo agregar la macro TARGETINGMAP a una etiqueta de anuncio:
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
A continuación, verá un ejemplo de la string completa de clave-valor cuando se publica el anuncio:
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
Puede usar esta macro para configurar una etiqueta de devoluciones entre dos redes de Ad Manager ("Red A" y "Red B").
El siguiente es un ejemplo de una creatividad reservada 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>
En caso de que la Red B de Ad Manager no tenga ninguna campaña vendida para publicar, puede devolver la impresión a la Red A mediante una creatividad de devoluciones, 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") // to avoid infinite loops
.display();
</script>También puede usar TARGETINGMAP en una etiqueta de devoluciones que se envíe en una solicitud a un servidor de publicidad de terceros, lo que le permitirá tener varios valores en una creatividad dinámica.
A continuación, verá un ejemplo de una creatividad reservada 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 publica, se expande de la siguiente manera:
<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 tercero ahora tiene acceso a los parámetros "dfpAdUnit" y "targeting" generados de forma dinámica y puede crear la siguiente devolución:
<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 ello, el tercero debe recibir un código de plantilla similar al siguiente:
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 usar la clave reservada url para expandir a la URL de la página de referencia.
Tenga en cuenta que url es una clave reservada. Todas las claves-valor de sus etiquetas de Campaign Manager 360 que tengan url como nombre de clave se sobrescribirán con la URL de referencia.
| Macro |
|---|
%%TAG_PARAM%% |
La macro de parámetros de etiquetas se usa junto con otros parámetros de etiquetas de anuncios y solo está disponible para usarse con los siguientes parámetros:
Cuando se admite, se expande al valor del parámetro.
Por ejemplo, %%TAG_PARAM:correlator%% (compatible) se expande al valor de correlator desde la etiqueta de anuncio, pero %%TAG_PARAM:ppid%% (no compatible) no se expande a ningún valor.
| Macro |
|---|
%%TARGET_IN_NEW_WINDOW%% |
La macro de destino en una ventana nueva indica si la configuración de ventana de destino especificada para la unidad de anuncios donde se publica una creatividad es "_blank" (ventana nueva) o diferente.
-
Si la ventana de destino es
_blank, la macro se expande a1. -
Si la ventana de destino tiene otro valor o no se especifica ninguna ventana, la macro se expande a
0.
Use la macro %%TARGET_WINDOW%% si quiere insertar el valor de la configuración de ventana de destino real.
| Macro |
|---|
%%TARGET_WINDOW%% |
La macro de ventana de destino se expande a la ventana de destino especificada para la unidad de anuncios donde se publica una creatividad. Puede usar la macro dentro del código de una creatividad para especificar si un clic que se haga en ella dirigirá al usuario a una ventana nueva o cargará la página de destino en la misma ventana, según la configuración del sitio en el que los usuarios vean el anuncio.
Por ejemplo, la unidad de anuncios AdManager_News.com tiene la ventana de destino configurada en _top y AdManager_Fashion.com, en _new. Si se incluye la macro %%TARGET_WINDOW%% en el código de la creatividad, se expandirá a _top para usuarios de AdManager_News.com y _new para los de AdManager_Fashion.com.
A continuación, verá un ejemplo de implementación:
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
Use la macro %%TARGET_IN_NEW_WINDOW%% si quiere determinar si el valor de configuración de la ventana de destino es "_blank" o un valor diferente.
| Macro |
|---|
%%TFCD%% |
La etiqueta de contenido dirigido a niños (TFCD) te permite informar a terceros que una solicitud de anuncio determinada proviene de una página con contenido dirigido a niños. La macro tiene como fin ayudar con el cumplimiento de la Ley de Protección de la Privacidad de Menores en Internet (COPPA).
Puede incluir la macro en cualquier redireccionamiento o solicitud para creatividades de terceros, con el formato coppa=%%TFCD%% o uno similar. También se puede usar en JavaScript para configurar solicitudes de etiquetas de devoluciones de GPT para el contenido dirigido a niños. La macro se expande a 1 para contenido dirigido a niños o 0 para otro contenido, según la información acerca de la naturaleza de la página, el sitio o la aplicación para dispositivos móviles que envió la solicitud a Ad Manager.
Si usa los servicios de publicidad de Google y quiere implementar contenido dirigido a niños a nivel del sitio o la aplicación, consulte el artículo sobre cómo etiquetar un sitio o una aplicación como contenido dirigido a niños.
| Macro |
|---|
[%URI_ENCODE:variable%] |
La macro de codificación de URI traduce correctamente espacios y otros caracteres especiales en valores de variables de la plantilla de creatividad para usarlos en los URI, también conocidos como URL.
Ejemplo
Supongamos que su plantilla de creatividad tiene una variable "list" llamada "Color" con dos valores: "dark blue" y "light green". De manera predeterminada, Ad Manager agrega [%Color%] a su fragmento de plantilla de creatividad:
<a href="https://paint.com/wall.html?color=[%Color%]">¡Pinta!</a>
Cuando se crea la creatividad, Ad Manager reemplaza [%Color%] con la string de texto literal de la línea de pedido seleccionada. En este ejemplo, las strings de texto literales contienen caracteres de espacio que romperán la URL, ya que es necesario codificarlos. Para evitar este problema, use [%URI_ENCODE:Color%].
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">¡Pinta!</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
Esta macro resulta especialmente útil cuando se usa una variable de plantilla de creatividad para definir una URL de clic o una URL de redireccionamiento. Si no se corrige la codificación, es posible que no funcione la URL completa de su creatividad.
Ejemplo
Supongamos que su plantilla de creatividad tiene una variable "URL" llamada "LandingPage". De manera predeterminada, Ad Manager agrega [%LandingPage%] a su fragmento de plantilla de creatividad:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">¡Haga clic aquí!</a>
Si la URL de [%LandingPage%] contiene parámetros de búsqueda, como ?page=home&sport=baseball, la URL presentará errores de formato y el redireccionamiento no funcionará como debería. En este ejemplo, el contenido después del signo de unión (&) se atribuirá a la URL completa en lugar de a la URL de redireccionamiento. Para evitar este problema, use [%URI_ENCODE:LandingPage%].
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">¡Haga clic aquí!</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Macros de seguimiento
Por lo general, estas macros se usan para generar informes y realizar seguimientos.
Cachebuster (número aleatorio)| Macro |
|---|
%%CACHEBUSTER%% |
La macro cachebuster garantiza que se hará una llamada nueva al servidor de anuncios cada vez que se ejecute el código para que puedas contar impresiones de manera precisa. Si no agregas la macro de almacenamiento en memoria caché al código de la creatividad, es posible que veas discrepancias en el recuento de impresiones entre Google Ad Manager y un servidor de publicidad de terceros. Ten en cuenta que no todos los terceros requieren la macro cachebuster.
La mayoría de los proveedores de creatividades ofrecerán un marcador de posición en su etiqueta para insertar macros cachebuster. Por ejemplo, si su código de creatividad de terceros contiene algo como lo siguiente:
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]
Debería seleccionar [RANDOM_NUMBER] y hacer clic en Insertar macro cachebuster para que reemplace el marcador de posición:
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER a fin de reducir las discrepancias cuando use el seguimiento de impresiones de Campaign Manager 360 para Ad Manager.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
Macros cachebuster en respuestas de VAST
La macro %%CACHEBUSTER%% se expande al mismo número aleatorio para todos los eventos de una creatividad determinada. Resulta particularmente útil para anuncios de video, ya que la macro se expande al mismo número aleatorio para cada evento de seguimiento en una respuesta de VAST.
| Macro | Escape |
|---|---|
%%CLICK_URL_UNESC%% |
Sin escape |
%%CLICK_URL_ESC%% |
Con escape |
%%CLICK_URL_ESC_ESC%% |
Con escape doble |
La macro de clics se expande a una URL especial para que pueda hacer un seguimiento en Ad Manager de las creatividades de terceros. Por lo general, esta macro se vincula con la URL de clic de una creatividad en el texto de hipervínculo (<a>). No ingrese la macro de clics como fuente de una imagen o un iframe. Si lo hace, se registrará un clic cada vez que se renderice la imagen o el iframe, lo cual no es legítimo y se filtra como un clic no válido.
Use %%CLICK_URL_UNESC%% al principio de un vínculo. Use %%CLICK_URL_ESC%% cuando la herramienta de seguimiento de clics sea el parámetro de otra 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>
Obtenga más información acerca de las macros con y sin escape.
Compruebe la implementación de su macro de clics
Una macro de clics que se coloque incorrectamente no registrará clics. Siga estos pasos para asegurarse de que Ad Manager registre los clics según sus preferencias.
- Obtenga una vista previa de la creatividad.
- Haga clic en la vista previa.
Ad Manager muestra una confirmación de que se registrarán los clics. Si no aparece el mensaje, significa que la macro de clics no está implementada de forma correcta.
| Macro | A qué se expande |
|---|---|
%eaid! |
ID de la línea de pedido |
%eadv! |
ID del anunciante para la línea de pedido que se publica |
%ebuy! |
ID de pedido para la línea de pedido que se publica |
%ecid! |
ID de creatividad |
%eenv! |
indicador de ambiente (tipo de etiqueta) i para iframe, j para JavaScript |
%epid! |
ID de la unidad de anuncios donde se publica la línea de pedido |
%esid! |
ID de la unidad de anuncios del nivel más alto sobre la unidad de anuncios donde se publica la línea de pedido
Esta es una macro heredada y es posible que no funcione con su red de la manera esperada.
|
Use las macros de expansión dentro del código de la creatividad personalizada o en una URL de clic para mostrar valores de ID de Ad Manager cuando publique una creatividad en una página. En ocasiones, esto se usa para hacer coincidir los ID de Ad Manager con los ID de la base de datos del publicador a fin de solucionar problemas o generar otros informes.
Las macros de expansión se pueden separar entre sí en la URL de clic con cualquier carácter que pueda usarse de manera segura en URL de clic de Ad Manager. Por ejemplo, http://www.site.com/?%eaid!;%ecid! se expande a http://www.site.com/?1234567;4265598.
| Macro |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (el identificador del dispositivo) |
%%ADVERTISING_IDENTIFIER_TYPE%% (el tipo del dispositivo) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (la configuración de Limitar el seguimiento de anuncios) |
La macro %%ADVERTISING_IDENTIFIER_PLAIN%% les permite a los publicadores que operan desde la aplicación enviar a los socios publicitarios un ID de dispositivo que se puede restablecer para que publiquen anuncios basados en intereses. De esta manera, puedes otorgarles a tus anunciantes y agencias acceso más fácil a los IDs de dispositivos que se pueden restablecer.
Los publicadores de la aplicación también pueden usar la macro %%ADVERTISING_IDENTIFIER_TYPE%% para enviar el tipo de dispositivo y la macro %%ADVERTISING_IDENTIFIER_IS_LAT%% para enviar la configuración de Limitar el seguimiento de anuncios (LAT), que señala el indicador Limitar el seguimiento de anuncios de un dispositivo.
Obtén más información sobre los IDs de dispositivos que se pueden restablecer para la segmentación de usuarios, incluidos los tipos de dispositivos compatibles.
Requisitos previos
Configure la encriptación de HTTPS para creatividades. Es un requisito tanto para la creatividad como para píxeles de terceros que usas para el seguimiento de conversiones. Si las creatividades no están encriptadas para HTTPS o si anulas la compatibilidad automática con SSL, la macro no expandirá el valor, pero las creatividades se publicarán de todas formas.
Cómo funciona
- En Ad Manager, el publicador incluye las macros en su creatividad o URLs de seguimiento.
-
Las macros se expanden para tener el ID de dispositivo del usuario, el tipo de dispositivo o la configuración de LAT, que luego se incluyen en la creatividad a medida que realizan llamadas al tercero.
Si la solicitud de anuncio proviene de una aplicación dirigida a niños (TFCD) o está activada la configuración de Limitar el seguimiento de anuncios (LAT), no se expandirá la macro de identificador. En estos casos, la macro muestra una string vacía ("").
Formato
Esta macro envía un valor de 32 dígitos hexadecimales en mayúscula, que se muestra en grupos de cinco y se separa con guiones, en el formato 8-4-4-4-12 para un total de 36 caracteres (32 caracteres alfanuméricos y 4 guiones).
Ejemplo: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Consulte los valores posibles para los tipos de dispositivos compatibles y la configuración de Limitar el seguimiento de anuncios (LAT).
| Macro |
|---|
%%PREVIEW_MODE%% |
Use la macro de modo de vista previa en el código de creatividad personalizado a fin de evitar el recuento de impresiones de vista previa por parte de sus sistemas de backend o de terceros. La macro se expande a true si se está observando la creatividad como vista previa de Ad Manager o a false si se trata de una impresión regular.
| Macro |
|---|
%%SCHEME%% |
La macro de esquema se expande a http: o https:, el que coincida con el esquema de seguridad de la página web donde se está publicando la creatividad. Puede colocarla al comienzo de una URL:
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| Macro |
|---|
%%SITE%% |
Se expande al dominio del parámetro de URL en una etiqueta de anuncio (por ejemplo, google.com). La macro se puede usar para modificar su creatividad en función de la procedencia de la solicitud. No funciona en anuncios de Ad Exchange que están marcados como anónimos.
| Macro | Escape |
|---|---|
%%VIEW_URL_ESC%% |
Con escape |
%%VIEW_URL_UNESC%% |
Sin escape |
La macro de impresión vista permite que Ad Manager cuente una impresión cada vez que se descarga una creatividad en el dispositivo del usuario y comienza a cargarse. Use esta macro únicamente en creatividades fuera de página.
Existen varias maneras de enviar un ping visto. Recomendamos usar una etiqueta <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">
La primera etiqueta <img> recupera una imagen de 1 x 1 de VIEW_URL. Configura el estilo en “display:none” para que esté oculto y no afecte el diseño de la página.
Macros de solicitud de anuncios para GDPR
Por lo general, estas macros se usan con solicitudes de anuncios que están sujetas al GDPR.
GDPR| Macro |
|---|
${GDPR} |
Se expande al valor de gdpr= asociado con la solicitud.
| Macro |
|---|
${GDPR_CONSENT_XXXX} |
Se expande a la string de transparencia y consentimiento (TC) asociada con la solicitud. Si la string de transparencia y consentimiento (TC) está en blanco o no es válida, no se expandirá la macro. Use esta macro para pasar la string de TC a un proveedor de creatividades externo en una URL de creatividades no programáticas.
Reemplaza "XXXX" con el ID de IAB GVL del proveedor externo. Si la string de TC está en blanco o no es válida, no se expandirá la macro.
Es posible que se bloqueen las creatividades que contengan la macro ${GDPR_CONSENT_XXXX} si el proveedor externo asociado con el ID de IAB GVL que insertó no cuenta con el consentimiento de los usuarios.
Si se usa en una etiqueta VAST y el proveedor externo no tiene el consentimiento del usuario, esta macro no se expandirá.
La macro ${GDPR_CONSENT_XXXX} solo debería ocurrir una vez en la URL. Comuníquese con su proveedor de creatividades externo a fin de conocer sus requisitos para pasar la string de TC y las restricciones de longitud de la URL. La macro se reemplazará con la string de TC completa y sin modificar en las solicitudes relevantes del MTC v2.0 de IAB.
Las macros del Marco de trabajo de transparencia y consentimiento (MTC) no se expanden cuando se implementan en el código HTML de una creatividad HTML5. Solo las creatividades de redireccionamiento de display y display personalizado admiten la expansión de macros de MTC mediante los campos "URL de terceros" y "Código HTML", respectivamente.
| Macro |
|---|
${ADDTL_CONSENT} |
Se expande a la string de consentimiento adicional (AC) asociada con la solicitud.
| Macro |
|---|
%%TFUA%% |
Se expande a un valor de 1 a fin de etiquetar la solicitud para usuarios del EEE y el Reino Unido que no alcanzan la edad de consentimiento.
Macros de video
Estas macros suelen usarse en creatividades de video para incluir detalles acerca del contexto o el contenido.
Duración del anuncio de video, en milisegundos| Macro |
|---|
%%VIDEO_AD_DURATION%% |
Se expande a la duración del anuncio de video en milisegundos. En el caso de los wrappers o redireccionamientos de VAST, la macro se expande a la duración declarada del anuncio en Ad Manager.
| Macro | Escape |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Sin escape |
%%DESCRIPTION_URL_ESC%% |
Con escape |
%%DESCRIPTION_URL_ESC_ESC%% |
Con escape doble |
Use %%DESCRIPTION_URL_ESC%% (con un solo escape) cuando la macro esté dentro de la URL y %%DESCRIPTION_URL_UNESC%% (sin escape) en otros contextos. Obtenga más información acerca de las diferencias entre las macros con y sin escape.
En etiquetas de anuncios de redireccionamiento, estas macros se expanden al parámetro de URL de descripción del parámetro de consulta description_url de Google Publisher Tag. La URL de descripción debería ser igual a la de referencia. Debe especificar la description_url en la etiqueta de Google Publisher Tag si hay incorporaciones en las que el SDK de IMA podría no detectar con precisión la URL de la página o si está usando video en Ad Exchange o AdSense para video.
%%DESCRIPTION_URL%%, que cumple la misma función que %%DESCRIPTION_URL_UNESC%%, por lo que no hay necesidad de volver a codificar creatividades ni plantillas anteriores.| Macro | Escape |
|---|---|
%%REFERRER_URL_UNESC%% |
Sin escape |
%%REFERRER_URL_ESC%% |
Con un solo escape |
%%REFERRER_URL_ESC_ESC%% |
Con escape doble |
Use %%REFERRER_URL_ESC%% (con un solo escape) cuando la macro esté dentro de una URL y %%REFERRER_URL_UNESC%% (sin escape) en otros contextos. Obtenga más información acerca de macros de URL con y sin escape.
La macro se expande a la URL de referencia (la URL de la página donde se encuentra el reproductor de video) en etiquetas de anuncios de redireccionamiento. El proceso se desarrolla de la siguiente manera: Ad Manager analiza el parámetro de búsqueda de URL de la etiqueta del anuncio, aísla la URL de referencia y reemplaza el texto de la macro con esa URL. Solo funciona con el SDK de IMA de Google y con las siguientes calificaciones:
- Para que funcione correctamente esta macro, se debe activar el acceso a la secuencia de comandos.
- La macro no funciona dentro de un iframe.
%%REFERRER_URL%%, que cumple la misma función que %%REFERRER_URL_UNESC%%, por lo que no hay necesidad de volver a codificar creatividades ni plantillas anteriores.Macros de contenido de video
Estas macros se usan para anuncios que se incluyen en la segmentación de fuentes del contenido de video.
| Macro |
|---|
%%VIDEO_DURATION%% |
Se expande a la duración del video en milisegundos.
| Macro |
|---|
%%VIDEO_ID%% |
Se expande al ID del contenido de video que se está reproduciendo, que es el ID único en CMS o el valor de dfpvideo:ContentID de MRSS.
| Macro |
|---|
%%VIDEO_METADATA:key%% |
Se expande a los metadatos acerca del video donde se publica la creatividad, en función de las claves-valor asociadas con el contenido del video. Estos pares clave-valor se configuran en la pestaña "Video" de Ad Manager.
Una vez que se segmenta una clave de metadatos de video, la macro de metadatos de video puede expandirla. La "clave" que se usa en la macro debe escribirse con caracteres alfanuméricos o guion bajo (_).
| Macro | Escape |
|---|---|
%%VIDEO_TITLE%% |
Con un solo escape |
La macro de título del video se expande para mostrar el título de un video según se define en Ad Manager.
Para que esta macro funcione, se requiere la transferencia de contenido.
| Macro |
|---|
%%FW_CAID%% |
Se expande al ID de anuncio personalizado de FreeWheel.
Esta macro solo se aplica a publicadores que usan FreeWheel para la publicación de anuncios de video.
| Macro |
|---|
%%IAB_CATEGORIES%% |
Se utiliza para pasar las categorías de anuncios de las creatividades que clasificó manualmente con etiquetas. Esta macro muestra una lista separada por comas de categorías estándar de la IAB aplicables (convertidas de las categorías clasificadas de Google).
Los publicadores que compartan inventario de video con FreeWheel y quieran pasar categorías de anuncios como parámetros personalizados pueden usar esta macro. Por ejemplo, podría agregar & iab_categories=%%IAB_CATEGORIES%% a su etiqueta de redireccionamiento de VAST.
