¿Qué es una macro VAST?

Una macro VAST es un token en mayúsculas entre corchetes, como [CACHEBUSTING] o [GDPRCONSENT], dentro de una URL de seguimiento de un anuncio de vídeo. El reproductor de vídeo o el ad server la reemplaza por un valor real en el momento en que se dispara el píxel.

¿Qué macros genera el expansor automáticamente?

[CACHEBUSTING] y [TIMESTAMP] son dinámicas: la herramienta construye un cache-buster aleatorio de 8 dígitos y una marca de tiempo ISO 8601 en UTC. Cada otra macro usa un valor de muestra incluido que puedes anular.

¿La herramienta descarga la etiqueta de anuncio o dispara realmente la URL de seguimiento?

No. Nunca hace una solicitud de red. Tú pegas la URL y la sustitución de macros ocurre localmente en tu navegador, así que nada se descarga, dispara ni registra en un servidor.

¿Por qué queda un token sin expandir en el resultado?

Solo se sustituyen las macros VAST 4.x canónicas en mayúsculas. Cualquier otra cosa —un error tipográfico, un token en minúsculas o un marcador personalizado— se reporta como desconocida y se pasa sin cambios.

¿Aplica percent-encoding a los valores que sustituye?

Sustituye los valores literalmente para que puedas leer los tokens sin procesar. Los reproductores reales aplican percent-encoding a campos como [PAGEURL] y las cadenas de consentimiento, así que codifícalos tú mismo si tu endpoint lo requiere.

¿En qué versión de VAST se basan las macros?

La referencia sigue el conjunto de macros de IAB VAST 4.x, incluidas macros de privacidad como [GDPR], [GDPRCONSENT], [US_PRIVACY], [GPP] y [GPPSID] introducidas en versiones recientes.

Expansor de macros VAST

Expande macros de IAB VAST 4.x en una URL de seguimiento y previsualiza la solicitud disparada, directamente en tu navegador. Las etiquetas pegadas permanecen en tu dispositivo.

El Expansor de macros VAST funciona por completo en tu navegador. Las URLs de seguimiento, las cadenas de consentimiento y los identificadores de dispositivo que pegas se analizan en tu dispositivo y nunca se suben a ArrayKit ni se envían a ningún ad server.

Acerca de Expansor de macros VAST

El Expansor de macros VAST convierte los tokens de marcador de posición de una URL de seguimiento de un anuncio de vídeo en una solicitud real y disparada, para que veas exactamente qué enviará tu reproductor. Pega un píxel de impresión, cuartil o error que contenga macros de IAB VAST 4.x —[CACHEBUSTING], [TIMESTAMP], [GDPR], [GDPRCONSENT], [US_PRIVACY], [IFA], [PAGEURL] y más— y la herramienta sustituye valores de muestra o tus propias anulaciones, generando al vuelo un cache-buster aleatorio y una marca de tiempo ISO. Una referencia con búsqueda explica cada macro y su categoría. Como las URLs de ad-ops llevan tan a menudo cadenas de consentimiento e identificadores de dispositivo, todo se ejecuta en tu dispositivo: la etiqueta que pegas se analiza en tu navegador y nunca se envía a un servidor.

Características

Expande cada macro de IAB VAST 4.x en una URL de impresión, seguimiento o error pegada
Genera automáticamente un número [CACHEBUSTING] aleatorio y un [TIMESTAMP] ISO 8601 en el momento del disparo
Las filas editables te permiten anular cualquier macro detectada con tu propio valor
El botón Regenerar vuelve a tirar el cache-buster dinámico y actualiza la marca de tiempo
Señala los tokens entre corchetes que no son macros VAST y los deja intactos
Referencia con búsqueda para macros como [IFA], [GDPRCONSENT], [GPP] y [ADCOUNT]
Copia toda la URL expandida o cualquier token de macro individual con un clic
Funciona por completo en tu navegador: las etiquetas y cadenas de consentimiento pegadas permanecen en tu dispositivo

Cómo usar Expansor de macros VAST

Mantén seleccionada la pestaña Expandir URL
Pega una URL de seguimiento o impresión que contenga macros VAST
Edita el valor de cualquier macro detectada, o pulsa Regenerar para un cache-buster y marca de tiempo nuevos
Copia la URL expandida, o cambia a Referencia de macros para consultar un token

Ejemplo

Entrada

https://ad.example.com/i?cb=[CACHEBUSTING]&ts=[TIMESTAMP]&gdpr=[GDPR]

Salida

https://ad.example.com/i?cb=12345678&ts=2025-03-04T05:06:07.000Z&gdpr=1

[CACHEBUSTING] se convierte en un entero aleatorio, [TIMESTAMP] en una hora ISO y [GDPR] en su valor de muestra.

Errores comunes y solución de problemas

La URL disparada sigue mostrando [SOMETHING] sin cambiar. — Ese token no es una macro VAST 4.x reconocida, así que se deja intacto. Las macros van en mayúsculas, como [CACHEBUSTING]: revisa la ortografía y las mayúsculas, o escribe el valor tú mismo.
La cadena de consentimiento o la URL de la página se ve rota al abrir el enlace expandido. — Los reproductores codifican en URL valores como [GDPRCONSENT] y [PAGEURL] antes de disparar. Esta vista previa los sustituye literalmente, así que aplícales percent-encoding tú mismo si tu endpoint lo espera.
Mi cache-buster es el mismo en cada vista previa. — La vista previa siembra un valor por URL. Haz clic en Regenerar para tirar un nuevo [CACHEBUSTING] aleatorio y actualizar el [TIMESTAMP].
El ad server ignora mi valor de [IFA]. — [IFA] debe emparejarse con [IFATYPE] y enviarse solo cuando el limit-ad-tracking lo permita. Confirma que el dispositivo realmente pasó un identificador antes de rellenar la macro.

Preguntas frecuentes

¿Qué es una macro VAST?: Una macro VAST es un token en mayúsculas entre corchetes, como [CACHEBUSTING] o [GDPRCONSENT], dentro de una URL de seguimiento de un anuncio de vídeo. El reproductor de vídeo o el ad server la reemplaza por un valor real en el momento en que se dispara el píxel.
¿Qué macros genera el expansor automáticamente?: [CACHEBUSTING] y [TIMESTAMP] son dinámicas: la herramienta construye un cache-buster aleatorio de 8 dígitos y una marca de tiempo ISO 8601 en UTC. Cada otra macro usa un valor de muestra incluido que puedes anular.
¿La herramienta descarga la etiqueta de anuncio o dispara realmente la URL de seguimiento?: No. Nunca hace una solicitud de red. Tú pegas la URL y la sustitución de macros ocurre localmente en tu navegador, así que nada se descarga, dispara ni registra en un servidor.
¿Por qué queda un token sin expandir en el resultado?: Solo se sustituyen las macros VAST 4.x canónicas en mayúsculas. Cualquier otra cosa —un error tipográfico, un token en minúsculas o un marcador personalizado— se reporta como desconocida y se pasa sin cambios.
¿Aplica percent-encoding a los valores que sustituye?: Sustituye los valores literalmente para que puedas leer los tokens sin procesar. Los reproductores reales aplican percent-encoding a campos como [PAGEURL] y las cadenas de consentimiento, así que codifícalos tú mismo si tu endpoint lo requiere.
¿En qué versión de VAST se basan las macros?: La referencia sigue el conjunto de macros de IAB VAST 4.x, incluidas macros de privacidad como [GDPR], [GDPRCONSENT], [US_PRIVACY], [GPP] y [GPPSID] introducidas en versiones recientes.

Herramientas relacionadas

Validador de VAST — Comprueba tu XML VAST contra las reglas del IAB en el navegador.
Inspector de etiquetas VAST — Analiza etiquetas VAST XML: estructura, media files y trackers.
Códigos de error VAST — Busca cualquier código de error VAST o VPAID del IAB y su solución.
Referencia de enums OpenRTB — Consulta cada lista enumerada de OpenRTB 2.x con su significado.
Constructor de schain — Construye y valida el objeto SupplyChain (schain) de OpenRTB.
Generador de ad units de Prebid — Construye una configuración de ad unit de Prebid.js y su snippet pbjs.