ZiTech
v1.0
Тема
⌘↵

Справка парсера

URL тега, макросы в query и ориентиры по рекламным платформам. Официальная спецификация IAB — источник истины для продакшена.

Структура URL, параметры и макросы

Типичный тег выглядит как https://хост/путь?ключ=значение&…. После «Парсить» ZiTag выделяет:

  • Базовый URL (BASE) — схема, хост и путь без строки запроса.
  • Инфраструктура — сопоставление хоста BASE и полных https://… в значениях параметров с внутренним каталогом доменов SSP/DSP.
  • Параметры — пары ключ=значение. Значения могут быть статическими, макросами в фигурных скобках ({ip}), в квадратных скобках (IAB), в виде %имя_поля% (часто Яндекс/Adfox; в query символ % передают как %25, например %25request.puid9%25 → после раскодирования %request.puid9%), либо полными https://… ссылками.
  • Макросы — подставляются плеером, SDK или сервером объявлений перед запросом. Сверяйте итоговый URL с гайдом вашей сети.

Совет: держите базовый URL на https://, чтобы избежать смешанного контента и блокировок в браузере и in-app WebView.

Макросы и параметры: IAB, Google GAM, OpenRTB / Prebid

Ниже сводка по открытым спецификациям и документации вендоров (2024–2026). Реальные имена в вашем теге всегда нужно сверять с интеграционным гайдом DSP/SSP.

IAB VAST 4.x — макросы в квадратных скобках

Подставляются видеоплеером или SSAI в URL трекеров. Полный перечень: IAB VAST 4.x Macros.

МакросНазначение (кратко)
[CACHEBUSTER]Случайное число против кэширования.
[TIMESTAMP]Время события.
[ERRORCODE]Код ошибки в Error URL.
[CONTENTPLAYHEAD]Позиция основного контента.
[MEDIAPLAYHEAD]Позиция рекламного ролика.
[ASSETURI]URI медиа креатива.
[UNIVERSALADID]Universal Ad ID.
[DEVICEUA] / [IP]UA и IP (если политика позволяет).
[PAGEURL] / [DOMAIN]Страница и домен.
[CONSENT] / [REGULATIONS]Согласия и регуляторика.
Google Ad Manager / IMA — частые query-параметры

Справочник: All VAST ad tag parameters. Для веба и приложений часть полей обязательна.

ПараметрНазначение
iuПуть рекламного блока /network_code/…/adunit.
szРазмер слота (например 640x360).
correlatorСлучайное целое на показ страницы; в IMA часто выставляет SDK.
description_urlURL страницы с описанием видео (для веба — URL-encoded).
cust_paramsПользовательский таргетинг key=val (через & внутри значения — кодировать).
outputФормат: vast, xml_vast4, vmap и др.
envvp (in-stream video) или instream (видео+аудио).
gdfp_reqПризнак запроса к инвентарю Google (обычно 1).
gdpr, gdpr_consent, us_privacyПриватность (EU / US).
plcmt, vpa, vpmuteТип размещения (OpenRTB), VPAID, mute.
min_ad_duration / max_ad_durationОграничения длительности ролика.
OpenRTB, Prebid, SSP — что часто встречается в query

Имена не унифицированы глобально: разные биржи используют site_id, tag_id, placement_id, publisher_id, deal_id, auction_id, imp_id, schain (supply chain), а также consent_string / TCF. Для видео SSP (SpotX, SpringServe и др.) встречаются параметры устройства, контента и приватности в стиле device_ifa, app_bundle, cb, ip_addr — смотрите гайд конкретной площадки.

Microsoft Xandr (креативные макросы)

В шаблонах креативов и расширениях VAST встречаются подстановки вида ${CACHEBUSTER}, ${AUCTION_ID}, ${CREATIVE_ID}, ${BID_PRICE} — регистр важен. Документация: Supported creative macros.

В таблице параметров ZiTag подсказка в колонке «Описание» подтягивается по имени параметра и по значению-макросу в фигурных {…} или квадратных […] скобках.

Популярные платформы: Россия и СНГ

Ниже типичные экосистемы, которые встречаются в тегах и VAST-ответах в регионе. Список не исчерпывающий; совпадение по домену в инструменте ZiTag/ZiChecker — эвристика для ориентира (виден ли в URL сторонний ad tech), а не вывод о настройке кампании.

  • Яндекс Реклама — поиск, сеть сайтов, приложения; часто домены yandex.ru, yandex.net, CDN yastatic.net.
  • Adfox — управление инвентарём издателей; интеграция с экосистемой Яндекса.
  • VK Реклама (myTarget) — соцсети, порталы Mail.ru; домены target.my.com, vk.com.
  • Between Digital — независимая SSP и точка входа в programmatic для паблишеров и DSP; экосистема Between Exchange объединяет продукты вроде видео-DSP ViHub, trading desk RTB-Media и аукцион Intency. Видео: in-stream (pre/mid/post), slider, in-page, mobile fullscreen. Интеграции по видео (в т.ч. header bidding / Prebid): Prebid Video — Between. Официальный сайт: betweendigital.ru. В теге и цепочке VAST часто встречаются хосты between.ru, between.ai, ads.betweendigital.com, betweendigital.com (CDN и ad server).
  • Buzzoola, Hybrid, Soloway, Getintent, Amberdata, OTM — региональные видео SSP/DSP и performance; в ZiTag они распознаются по домену из BASE или https-значений параметров — сверяйте макросы и требования с гайдом поставщика.
  • Операторы и финтех — рекламные продукты на доменах операторов и банков (например МТС, Сбер) — уточняйте требования у поставщика.
Популярные платформы: международный рынок
  • Google (GAM / GDFP, IMA)doubleclick.net, googlesyndication.com и др.
  • Amazon Advertising / APS — retail и CTV.
  • Xandr, Magnite, PubMatic, OpenX, Index Exchange — SSP и биржи.
  • SpotX, SpringServe, FreeWheel — видео и CTV.
  • Equativ (Smart), Adform, Criteo, The Trade Desk — ad server и DSP.
  • Taboola, Outbrain, TripleLift, Sharethrough — native и feed.
  • IAS, DoubleVerify, Moat — verification (видимость, brand safety) — отдельные пиксели в цепочке.
  • Unity Ads, ironSource, AppLovin, Vungle, Chartboost, Smaato — mobile и игры.
Ссылка VAST
URL

Кнопка «Анализировать» загружает VAST по ссылке выше; ответ появляется в XML ниже.

XML просмотр и правка
Tab ⌘↵

Справка валидатора

Разметка XML VAST, события, медиа, коды ошибок и ожидания плееров. Официальная спецификация IAB — источник истины для продакшена.

Версии VAST (2.x, 3.x, 4.x)
ВерсияКлючевые особенности
2.0Базовый линейный креатив, Impression, Tracking, ClickThrough, Error; без формального skipoffset у Linear в спецификации.
3.0Пропуск рекламы (skipoffset на Linear), расширенные события, AdParameters, удобнее для mobile-сценариев.
4.0+UniversalAdId, AdVerifications (OMID), Mezzanine, Pricing, InteractiveCreativeFile (SIMID), AdServingId, уточнения для CTV и адресуемости.

Многие SSP указывают VAST 3.x или 4.x; фактическая разметка должна соответствовать объявленной версии, иначе строгие SDK могут отклонить ответ.

Ответ с объявленной VAST 2.x часть современных бирж и строгих плееров может не принять — для новых интеграций ориентируйтесь на 3.x или 4.x, если площадка это допускает.

Атрибут event у <Tracking> (линейная реклама)

Полный перечень — в спецификации IAB. Ниже частые значения для прогресса и взаимодействия.

eventНазначение
start, firstQuartile, midpoint, thirdQuartile, completeКвартильная схема воспроизведения; для отчётности у бирж и DSP обычно нужен полный набор вместе с Impression.
mute, unmute, pause, resumeГромкость и пауза.
fullscreen, exitFullscreenПолноэкранный режим.
skipПропуск объявления (VAST 3+ и поддержка skip у креатива).
progressС привязкой к offset (например 00:00:05.000 или 50%).
creativeViewПросмотр креатива (non-linear и др.).
acceptInvitation, close, collapse, expandNon-linear / expandable.
MediaFile: type, delivery, apiFramework
ПолеТипичные значения
type (MIME)video/mp4, video/webm, application/javascript (VPAID), application/vnd.apple.mpegurl (HLS).
deliveryprogressive — файл по HTTP(S); streaming — поток (HLS/DASH; поддержка зависит от плеера).
apiFrameworkVPAID, MRAID и др. — интерактив поверх видео.

Для CTV и мобильных приложений чаще всего нужен MP4 без VPAID; WebM на iOS не поддерживается.

Атрибуты width и height у прогрессивного видео помогают плееру выбрать подходящий вариант из нескольких MediaFile; без них часть SDK ведёт себя менее предсказуемо.

Корректный type (MIME), например video/mp4, снижает риск отказа при выборе декодера — особенно на TV-браузерах и встроенных плеерах.

Коды <Error> и макрос [ERRORCODE]

URL в Error часто дополняется макросом [ERRORCODE]. Ниже ориентиры по диапазонам; точные коды — в документе IAB VAST.

КодСмысл (кратко)
100–102Ошибка разбора XML / валидации VAST.
200–203Проблемы воспроизведения медиа (не найдено, неподдерживаемый тип и т.д.).
300–303Timeout / недоступность ресурсов.
400–403Ошибки враппера / цепочки VAST.
600–603Ошибки интерактива / VPAID / несовместимости.
900–901Общая / неизвестная ошибка.
Google IMA SDK и макросы

IMA подставляет макросы в URL трекеров (время просмотра, причина пропуска и т.д.). Набор зависит от версии SDK и политики Google. При отладке сравнивайте фактический HTTP-запрос с шаблоном в VAST и документацией IMA.

На HTTPS-страницах все трекеры и медиа должны быть по https://, иначе возможны блокировки mixed content.

Если в VAST есть VPAID (application/javascript, apiFramework="VPAID"), учитывайте среду показа: в Google IMA SDK 3.x классический VPAID по умолчанию отключён в пользу измеримости через OMID и интерактива через SIMID. Для плееров без IMA (свой HTML5, другие SDK) это не универсальное ограничение — сверяйтесь с гайдом площадки.

При цепочке Wrapper у IMA на каждый уровень действуют таймауты (порядка нескольких секунд) — глубокая вложенность повышает риск обрыва. Для выбора формата SDK чаще ориентируется на video/mp4; если в ответе только WebM или HLS без MP4, поведение зависит от версии и настроек плеера.

Инфраструктура и строка «Платформы» в сводке

Карточки в блоке «Инфраструктура» и строка compliance Платформы строятся по доменам из трекеров, медиа, цепочки врапперов и по тексту <AdSystem>. Это внутренний справочник по популярным SSP/DSP, а не вывод о настройке кампании — уточняйте макросы и требования у поставщика.

OMID и SIMID
  • Open Measurement (OMID) — измеримость показов через AdVerifications и OMSDK; актуально для VAST 4.x и верификации независимыми поставщиками.
  • SIMID — интерактив поверх видео через InteractiveCreativeFile; в ряде сценариев приходит на смену VPAID.
CTV, мобильные приложения и ограничения плееров

На Smart TV и приставках часто нет полноценного JS/VPAID. Ориентируйтесь на video/mp4 (progressive или поддерживаемый стриминг), избегайте обязательной зависимости только от VPAID, проверяйте разрешение и битрейт под большой экран.

Если в одном InLine есть и VPAID, и обычный video/mp4, на типичном CTV-плеере чаще проиграется только MP4, а VPAID будет проигнорирован — это ограничение ТВ-среды, а не «ошибка» тега для веба.

SIMID (InteractiveCreativeFile) и разметка NonLinear на большинстве CTV SDK не поддерживаются — рассчитывайте, что на приставке эти части не отработают.

В мобильных in-app плеерах (в т.ч. с IMA и др. SDK) классический VPAID часто недоступен; только WebM без MP4 на iOS обычно не воспроизводится — в сводке compliance остаются жёсткие пометки «только VPAID» / «только WebM», если в ответе нет подходящего видео для этих сред.

В приложениях учитывайте ATS (iOS), политики сети (Android), обязательность рекламного идентификатора (GAID/IDFA) и корректность store URL.