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 sugerencias 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 cómo utilizar macros con escape y sin escape. - Inserción de macros
Ad Manager inserta las macros automáticamente en las creatividades de terceros o en las URLs de etiquetas VAST, siempre que Ad Manager reconozca los terceros. 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.
Si se hace el traficado con una plantilla de creatividad, solo aparecerá una entrada de URL de destino cuando se utilice una macro de clics en la plantilla. - Caracteres reservados y codificación de URLs (codificación porcentual)
Ad Manager reserva algunas letras en minúscula precedidas de un símbolo de porcentaje:%a
%c
%h
%i
%n
%p
%kEstas cadenas no se deben usar en la codificación de URLs, ya que pueden interferir con la expansión de macros.
- Las macros no son compatibles con la programática directa
Consulte las funciones disponibles en la programática directa.
Ir a una macro concreta de la lista
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.
Así es como se añadiría 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 aparece en la solicitud de anuncio original, incluido el código de red. Este es un ejemplo de cómo se expandiría la ruta del bloque de anuncios al servirse el anuncio:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/sitio/seccion"<>/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 la 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.
| 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 valores definidos para que prevalezcan, correspondientes a 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. Esta macro puede ser útil si el código de la creatividad debe incluir la URL de destino de la creatividad y esta cambia cuando la creatividad o la plantilla se utilizan en distintas líneas de pedido.
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 externa de seguimiento de clics. Algunas de estas empresas requieren una URL con formato de escape, mientras que otras no. El nivel de escape que requieren las empresas externas de seguimiento de clics suele indicarse en la etiqueta con la cadena click= de la etiqueta de anuncio de terceros o en el código de la creatividad personalizada 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%%).
%%DEST_URL%%, que tiene exactamente 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.%u o %%DEST_URL%%, se le dirigirá 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 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 creatividades personalizadas.
Para usar esta macro, sustituya file_display_name por el nombre visible del recurso de la creatividad que se muestra en Ad Manager cuando consulta los datos de la creatividad.
| 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.
| 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:
- 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"); - En la creatividad personalizada o de terceros, transfiera dinámicamente el valor personalizado (el sexo del usuario) mediante la siguiente macro:
<algún código de creatividad>...&gender=%%PATTERN:gender%% - La macro completa
%%PATTERN:gender%%se sustituirá por "male" (hombre). - 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();
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>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.
| Macro |
|---|
%%TAG_PARAM%% |
La macro de parámetro de etiqueta se usa junto con otros parámetros de etiquetas de anuncio y solo se puede utilizar con los siguientes parámetros:
Cuando es compatible, se expande al valor del parámetro.
Por ejemplo, %%TAG_PARAM:correlator%% (compatible) se expande al valor del parámetro "correlator" de 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 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 a1. -
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%%.
| 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="my ad"></a>
Para averiguar si el ajuste de la ventana de destino es "_blank" u otro valor, utilice la macro %%TARGET_IN_NEW_WINDOW%%.
| 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 de EE. UU (Children's Online Privacy Protection Act, COPPA).
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.
| 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.
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? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
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 de cache busting 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 externo. 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%%
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.
| 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 registrar los 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.
- Obtenga una vista previa de la creatividad.
- 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.
| 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.
|
Use 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 URLs de destino mediante cualquier carácter que se pueda usar en ese tipo de URLs de Ad Manager. Por ejemplo, http://www.site.com/?%eaid!;%ecid! se expande a http://www.site.com/?1234567;4265598.
| Macro |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (identificador de dispositivo) |
%%ADVERTISING_IDENTIFIER_TYPE%% (tipo de dispositivo) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (ajuste para limitar el seguimiento de anuncios) |
La macro %%ADVERTISING_IDENTIFIER_PLAIN%% permite que los editores de anuncios en aplicaciones envíen IDs de dispositivo que se pueden cambiar a los partners publicitarios para servir anuncios basados en intereses. De esta forma, le resultará más fácil dar acceso a sus anunciantes y agencias a sus IDs de dispositivo que se pueden cambiar.
Los editores de anuncios en aplicaciones también pueden usar 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), que indica la señal de limitación del seguimiento de anuncios de un dispositivo.
Consulte más información sobre los IDs de dispositivos que se pueden cambiar para usarlos en la segmentación de usuarios, incluidos los tipos de dispositivos admitidos.
Requisitos previos
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 o anula la compatibilidad automática con SSL, la macro no expandirá el valor, pero las creatividades seguirán publicándose.
Cómo funciona
- En Ad Manager, los editores añaden las macros en las creatividades o en las URLs de seguimiento.
-
Las macros se sustituyen por el ID de dispositivo del usuario, el tipo de dispositivo o el ajuste LAT. Estos valores se incluyen en la creatividad cuando 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
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).
| Macro |
|---|
%%PREVIEW_MODE%% |
Use la macro de modo de vista previa en el código de la creatividad personalizada para evitar que los sistemas de backend 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.
| 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 sirve la creatividad. Puede colocarla al principio de una URL de la siguiente manera:
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| 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.
| 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 el navegador envíe una solicitud 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 solicitudes de anuncios del 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.
| 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.
Si se usa en una etiqueta VAST y el proveedor externo no cuenta con el consentimiento del usuario, esta macro no se expandirá.
La macro ${GDPR_CONSENT_XXXX} solo debe aparecer una vez en la URL. 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.
Las macros del Marco de Transparencia y Consentimiento (TCF) no se expanden cuando se implementan en el HTML de una creatividad HTML5. Solo las creatividades de redirección de display y de display personalizadas admiten macros de TCF expandibles mediante los campos "URL de terceros" y "Código HTML", respectivamente.
| Macro |
|---|
${ADDTL_CONSENT} |
Se expande a la cadena de consentimiento adicional (AC) asociada a la solicitud.
| 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.
Macros de vídeo
Estas macros se utilizan habitualmente en creatividades de vídeo para incluir detalles sobre el contexto o el contenido.
Duración de un anuncio de vídeo, en milisegundos| Macro |
|---|
%%VIDEO_AD_DURATION%% |
Se expande a la duración del anuncio de vídeo en milisegundos. En el caso de los envoltorios o redirecciones de VAST, la macro se expande a la duración declarada del anuncio en Ad Manager.
| 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 URLs de descripción deben ser idénticas a las URLs 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.
%%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 de plantillas antiguas.| 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.
%%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.
| Macro |
|---|
%%VIDEO_DURATION%% |
Se expande a la duración del vídeo en milisegundos.
| 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.
| 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.
Una vez que se haya incluido una clave de metadatos de vídeo en la segmentación, se puede expandir mediante la macro de metadatos de vídeo. La "clave" utilizada en la macro debe estar formada por caracteres alfanuméricos o por el guion bajo (_).
| 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.
| 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.
| Macro |
|---|
%%IAB_CATEGORIES%% |
Se usa 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 usar 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.
