Раскрытие макросов VAST
Раскрывайте макросы IAB VAST 4.x в трекинг-URL и предпросматривайте запрос, который будет отправлен, прямо в браузере. Вставленные теги остаются на вашем устройстве.
Раскрытие макросов VAST работает целиком в вашем браузере. Трекинг-URL, строки согласия и идентификаторы устройств, которые вы вставляете, разбираются на вашем устройстве и никогда не загружаются в ArrayKit и не отправляются на какой-либо рекламный сервер.
Об инструменте Макросы VAST
Раскрытие макросов VAST превращает токены-заполнители в трекинг-URL видеорекламы в реальный отправляемый запрос, чтобы вы точно увидели, что отправит ваш плеер. Вставьте пиксель показа, квартиля или ошибки, содержащий макросы IAB VAST 4.x — [CACHEBUSTING], [TIMESTAMP], [GDPR], [GDPRCONSENT], [US_PRIVACY], [IFA], [PAGEURL] и другие — и инструмент подставит примерные значения или ваши собственные переопределения, генерируя на лету случайный cache-buster и ISO-метку времени. Справочник с поиском объясняет каждый макрос и его категорию. Поскольку ad-ops URL так часто несут строки согласия и идентификаторы устройств, всё работает на вашем устройстве: тег, который вы вставляете, разбирается в вашем браузере и никогда не отправляется на сервер.
Возможности
- Раскрывает каждый макрос IAB VAST 4.x во вставленном URL показа, трекинга или ошибки
- Автоматически генерирует случайное число [CACHEBUSTING] и метку [TIMESTAMP] в формате ISO 8601 в момент срабатывания
- Редактируемые строки позволяют переопределить любой обнаруженный макрос своим значением
- Кнопка «Перегенерировать» заново прокатывает динамический cache-buster и обновляет метку времени
- Помечает токены в квадратных скобках, которые не являются макросами VAST, и оставляет их нетронутыми
- Справочник с поиском для макросов вроде [IFA], [GDPRCONSENT], [GPP] и [ADCOUNT]
- Скопируйте весь раскрытый URL или любой отдельный токен макроса в один клик
- Работает целиком в вашем браузере — вставленные теги и строки согласия остаются на вашем устройстве
Как использовать Макросы VAST
- Оставьте выбранной вкладку «Раскрыть URL»
- Вставьте трекинг- или показ-URL, содержащий макросы VAST
- Отредактируйте любое обнаруженное значение макроса или нажмите «Перегенерировать» для свежего cache-buster и метки времени
- Скопируйте раскрытый URL или переключитесь на «Справочник макросов», чтобы найти токен
Пример
Ввод
https://ad.example.com/i?cb=[CACHEBUSTING]&ts=[TIMESTAMP]&gdpr=[GDPR]
Результат
https://ad.example.com/i?cb=12345678&ts=2025-03-04T05:06:07.000Z&gdpr=1
[CACHEBUSTING] становится случайным числом, [TIMESTAMP] — временем ISO, а [GDPR] — своим примерным значением.
Частые ошибки и устранение неполадок
- В отправляемом URL по-прежнему виден [SOMETHING] без изменений. — Этот токен не является распознанным макросом VAST 4.x, поэтому он оставлен как есть. Макросы записываются заглавными буквами, например [CACHEBUSTING] — проверьте написание и регистр или впишите значение сами.
- Строка согласия или URL страницы выглядят сломанными, когда я открываю раскрытую ссылку. — Плееры URL-кодируют значения вроде [GDPRCONSENT] и [PAGEURL] перед срабатыванием. Этот предпросмотр подставляет их буквально, поэтому кодируйте их в проценты сами, если ваш эндпоинт этого ожидает.
- Мой cache-buster одинаков в каждом предпросмотре. — Предпросмотр задаёт одно значение на URL. Нажмите «Перегенерировать», чтобы прокатить новый случайный [CACHEBUSTING] и обновить [TIMESTAMP].
- Рекламный сервер игнорирует моё значение [IFA]. — [IFA] должен идти в паре с [IFATYPE] и отправляться только когда это разрешает limit-ad-tracking. Убедитесь, что устройство действительно передало идентификатор, прежде чем макрос будет заполнен.
Часто задаваемые вопросы
- Что такое макрос VAST?
- Макрос VAST — это токен заглавными буквами в квадратных скобках, например [CACHEBUSTING] или [GDPRCONSENT], внутри трекинг-URL видеорекламы. Видеоплеер или рекламный сервер заменяет его реальным значением в момент срабатывания пикселя.
- Какие макросы раскрытие генерирует автоматически?
- [CACHEBUSTING] и [TIMESTAMP] динамические: инструмент строит случайный 8-значный cache-buster и метку времени UTC в формате ISO 8601. Каждый другой макрос использует встроенное примерное значение, которое можно переопределить.
- Запрашивает ли инструмент рекламный тег или действительно срабатывает трекинг-URL?
- Нет. Он никогда не делает сетевой запрос. Вы вставляете URL, и подстановка макросов происходит локально в вашем браузере, поэтому ничего не запрашивается, не срабатывает и не логируется на сервер.
- Почему токен остаётся нераскрытым в выводе?
- Подставляются только канонические заглавные макросы VAST 4.x. Всё остальное — опечатка, токен в нижнем регистре или кастомный заполнитель — помечается как неизвестное и передаётся без изменений.
- URL-кодирует ли он подставляемые значения?
- Он подставляет значения буквально, чтобы вы могли читать сырые токены. Реальные плееры кодируют в проценты поля вроде [PAGEURL] и строки согласия, поэтому кодируйте их сами, если ваш эндпоинт этого требует.
- На какой версии VAST основаны макросы?
- Справочник следует набору макросов IAB VAST 4.x, включая макросы приватности вроде [GDPR], [GDPRCONSENT], [US_PRIVACY], [GPP] и [GPPSID], введённые в недавних версиях.
Связанные инструменты
- Валидатор VAST — Проверьте VAST XML по правилам IAB прямо в браузере.
- Инспектор VAST — Разберите VAST-тег на InLine/Wrapper, медиафайлы и трекинг-URL.
- Коды ошибок VAST — Найдите любой код ошибки IAB VAST или VPAID с его значением и причиной.
- Enum OpenRTB — Ищите перечислимые списки OpenRTB 2.x — каждый код с его значением.
- Сборщик schain — Соберите и проверьте объект IAB SupplyChain для OpenRTB.
- Генератор Prebid — Соберите конфиг ad unit Prebid.js и сниппет pbjs.addAdUnits().
Все инструменты ArrayKit