O que é uma macro VAST?

Uma macro VAST é um token em maiúsculas entre colchetes, como [CACHEBUSTING] ou [GDPRCONSENT], dentro de uma URL de rastreamento de anúncio de vídeo. O player de vídeo ou o ad server a substitui por um valor real no momento em que o pixel dispara.

Quais macros o expansor gera automaticamente?

[CACHEBUSTING] e [TIMESTAMP] são dinâmicas: a ferramenta cria um cache-buster aleatório de 8 dígitos e um timestamp ISO 8601 em UTC. Toda outra macro usa um valor de exemplo embutido que você pode sobrescrever.

A ferramenta busca a tag de anúncio ou de fato dispara a URL de rastreamento?

Não. Ela nunca faz uma requisição de rede. Você cola a URL e a substituição das macros acontece localmente no seu navegador, então nada é buscado, disparado ou registrado em um servidor.

Por que um token fica sem expandir na saída?

Apenas macros VAST 4.x canônicas em maiúsculas são substituídas. Qualquer outra coisa — um erro de digitação, um token em minúsculas ou um espaço reservado personalizado — é reportada como desconhecida e passada adiante sem alteração.

Ela aplica percent-encoding nos valores que substitui?

Ela substitui valores literalmente para que você leia os tokens brutos. Players reais aplicam percent-encoding em campos como [PAGEURL] e consent strings, então codifique-os você mesmo se seu endpoint exigir.

Em qual versão do VAST as macros se baseiam?

A referência segue o conjunto de macros VAST 4.x da IAB, incluindo macros de privacidade como [GDPR], [GDPRCONSENT], [US_PRIVACY], [GPP] e [GPPSID] introduzidas em versões recentes.

Expansor de Macros VAST

Expanda macros VAST 4.x da IAB em uma URL de rastreamento e veja a prévia da requisição disparada, direto no seu navegador. Tags coladas ficam no seu dispositivo.

O Expansor de Macros VAST roda inteiramente no seu navegador. As URLs de rastreamento, consent strings e identificadores de dispositivo que você cola são analisados no seu dispositivo e nunca são enviados à ArrayKit ou a qualquer ad server.

Sobre Expansor de Macros VAST

O Expansor de Macros VAST transforma os tokens de espaço reservado em uma URL de rastreamento de anúncio de vídeo em uma requisição real e disparada, para que você veja exatamente o que seu player vai enviar. Cole um pixel de impression, quartil ou erro que contenha macros VAST 4.x da IAB — [CACHEBUSTING], [TIMESTAMP], [GDPR], [GDPRCONSENT], [US_PRIVACY], [IFA], [PAGEURL] e mais — e a ferramenta substitui valores de exemplo ou seus próprios overrides, gerando um cache-buster aleatório e um timestamp ISO na hora. Uma referência pesquisável explica cada macro e sua categoria. Como URLs de ad-ops tantas vezes carregam consent strings e identificadores de dispositivo, tudo roda no seu dispositivo: a tag que você cola é analisada no seu navegador e nunca é enviada a um servidor.

Recursos

Expande cada macro VAST 4.x da IAB em uma URL de impression, rastreamento ou erro colada
Gera automaticamente um número [CACHEBUSTING] aleatório e um [TIMESTAMP] ISO 8601 no momento do disparo
Linhas editáveis permitem sobrescrever qualquer macro detectada com seu próprio valor
Botão Regenerar re-sorteia o cache-buster dinâmico e atualiza o timestamp
Sinaliza tokens entre colchetes que não são macros VAST e os deixa intactos
Referência pesquisável para macros como [IFA], [GDPRCONSENT], [GPP] e [ADCOUNT]
Copie a URL expandida inteira ou qualquer token de macro isolado com um clique
Roda inteiramente no seu navegador — tags coladas e consent strings ficam no seu dispositivo

Como usar Expansor de Macros VAST

Mantenha a aba Expandir URL selecionada
Cole uma URL de rastreamento ou impression que contenha macros VAST
Edite qualquer valor de macro detectado, ou clique em Regenerar para um cache-buster e timestamp novos
Copie a URL expandida, ou mude para a Referência de Macros para consultar um token

Exemplo

Entrada

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

Saída

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

[CACHEBUSTING] vira um inteiro aleatório, [TIMESTAMP] um horário ISO e [GDPR] seu valor de exemplo.

Erros comuns e solução de problemas

A URL disparada ainda mostra [SOMETHING] inalterado. — Esse token não é uma macro VAST 4.x reconhecida, então é deixado intacto. Macros são em maiúsculas, como [CACHEBUSTING] — confira a grafia e as maiúsculas, ou digite o valor você mesmo.
A consent string ou a URL da página parecem quebradas quando abro o link expandido. — Players codificam em URL valores como [GDPRCONSENT] e [PAGEURL] antes de disparar. Esta prévia os substitui literalmente, então aplique percent-encoding você mesmo se seu endpoint exigir.
Meu cache-buster é o mesmo em toda prévia. — A prévia semeia um valor por URL. Clique em Regenerar para sortear um novo [CACHEBUSTING] aleatório e atualizar o [TIMESTAMP].
O ad server ignora meu valor de [IFA]. — [IFA] deve ser combinado com [IFATYPE] e enviado apenas quando o limit-ad-tracking permitir. Confirme que o dispositivo de fato passou um identificador antes de a macro ser preenchida.

Perguntas frequentes

O que é uma macro VAST?: Uma macro VAST é um token em maiúsculas entre colchetes, como [CACHEBUSTING] ou [GDPRCONSENT], dentro de uma URL de rastreamento de anúncio de vídeo. O player de vídeo ou o ad server a substitui por um valor real no momento em que o pixel dispara.
Quais macros o expansor gera automaticamente?: [CACHEBUSTING] e [TIMESTAMP] são dinâmicas: a ferramenta cria um cache-buster aleatório de 8 dígitos e um timestamp ISO 8601 em UTC. Toda outra macro usa um valor de exemplo embutido que você pode sobrescrever.
A ferramenta busca a tag de anúncio ou de fato dispara a URL de rastreamento?: Não. Ela nunca faz uma requisição de rede. Você cola a URL e a substituição das macros acontece localmente no seu navegador, então nada é buscado, disparado ou registrado em um servidor.
Por que um token fica sem expandir na saída?: Apenas macros VAST 4.x canônicas em maiúsculas são substituídas. Qualquer outra coisa — um erro de digitação, um token em minúsculas ou um espaço reservado personalizado — é reportada como desconhecida e passada adiante sem alteração.
Ela aplica percent-encoding nos valores que substitui?: Ela substitui valores literalmente para que você leia os tokens brutos. Players reais aplicam percent-encoding em campos como [PAGEURL] e consent strings, então codifique-os você mesmo se seu endpoint exigir.
Em qual versão do VAST as macros se baseiam?: A referência segue o conjunto de macros VAST 4.x da IAB, incluindo macros de privacidade como [GDPR], [GDPRCONSENT], [US_PRIVACY], [GPP] e [GPPSID] introduzidas em versões recentes.

Ferramentas relacionadas

Validador VAST — Valide tags VAST XML contra as regras da IAB no navegador
Inspetor de Tag VAST — Analise a estrutura, a mídia e os rastreadores de uma tag VAST XML
Códigos de Erro VAST — Consulte qualquer código de erro VAST ou VPAID e sua correção
Referência de Enums OpenRTB — Consulte cada lista enumerada do OpenRTB 2.x e seus códigos
Construtor de schain — Monte e valide o objeto SupplyChain (schain) do OpenRTB
Gerador de Ad Unit Prebid — Monte uma config de ad unit Prebid.js e o snippet pbjs.addAdUnits()