VMAP 校验器与广告插播时间轴
校验 VMAP 广告插播 XML,并在时间轴上查看前贴、中插和后贴广告插播,全部在你的浏览器中完成。
VMAP 校验器完全在你的浏览器中解析你的播放列表。你粘贴的 XML 留在你的设备上,每个插播背后的 AdTagURI 和 VAST 绝不会被请求,也不会有任何内容上传到 ArrayKit。
打开 VAST 校验器
关于 VMAP 校验器
VMAP 校验器解析一个 Video Multiple Ad Playlist,并在你把它投给播放器之前告诉你每个广告插播是否排期正确。粘贴你的 VMAP XML,它会读取每个 vmap:AdBreak,检查 timeOffset 格式(start、end、HH:MM:SS.mmm、百分比或 #n 位置),确认 breakType 为 linear、nonlinear 或 display,并核实 AdSource 是否携带内联 VASTAdData 或 AdTagURI。有效的插播会布置在前贴、中插和后贴的时间轴上,让你一眼看清广告 pod 排期,而有问题的插播会就地标出。它为调试服务端广告插入和 CTV 播放列表的 ad-ops 工程师和视频开发者打造,完全在你的浏览器中运行——播放列表留在你的设备上,任何广告标签都绝不会被调用。
功能特性
- 校验每个 vmap:AdBreak 是否具有格式良好的 timeOffset、breakType 和 AdSource
- 识别 start、end、HH:MM:SS.mmm、百分比和 #n 位置偏移
- 在可视化时间轴上布置前贴、中插和后贴插播
- 就地标出缺失的 AdSource、空的广告数据和未知的 timeOffset 格式
- 为每个插播区分内联 VASTAdData 与 AdTagURI 重定向
- 以精确的行号和列号报告格式错误的 XML
- 按插播位统计插播数,让你一眼确认广告 pod 排期
- 完全在你的浏览器中运行——播放列表和任何 AdTagURI 都绝不会被抓取
如何使用 VMAP 校验器
- 把你的 VMAP XML 粘贴到输入框,或加载示例播放列表
- 查看汇总标签中的插播总数以及前 / 中 / 后贴的合计
- 扫视时间轴,确认每个 AdBreak 落在正确的插播位
- 展开任何被标红的插播,查看是哪个属性或 AdSource 出了错
示例
输入
<vmap:VMAP xmlns:vmap="http://www.iab.net/videosuite/vmap" version="1.0">
<vmap:AdBreak timeOffset="start" breakType="linear" breakId="pre">
<vmap:AdSource>
<vmap:AdTagURI><![CDATA[https://ads.example/vast]]></vmap:AdTagURI>
</vmap:AdSource>
</vmap:AdBreak>
</vmap:VMAP>
输出
Valid VMAP · 1 break · 1 pre-roll
AdBreak "pre" — start · linear · Ad tag URI
一个指向 AdTagURI 的单前贴 AdBreak 校验通过。
常见错误与故障排除
- 某个插播被标为 'unrecognized timeOffset'。 — VMAP 接受 start、end、绝对时间 HH:MM:SS.mmm、如 25% 的百分比,或 #n 位置标记。裸的秒数或多余的空格都不匹配——请使用上述精确形式之一。
- 某个插播显示 'missing <vmap:AdSource>'。 — 每个 AdBreak 都需要一个 AdSource,携带内联 VASTAdData、AdTagURI 或 CustomAdData。请添加一个,或从播放列表中移除空插播。
- 整个文档因 'Missing <vmap:VMAP> root' 而失败。 — 你很可能粘贴了裸的 VAST 标签,而非其 VMAP 包装。VMAP 负责排期广告插播;每个插播的 VAST 位于 VASTAdData 中或 AdTagURI 处。
- 根元素因缺少 version 而被标记。 — <vmap:VMAP> 元素需要一个 version 属性——请在开标签中添加 version="1.0"。
常见问题
- 什么是 VMAP,它与 VAST 有何不同?
- VMAP(Video Multiple Ad Playlist)是一个排期包装,告诉播放器何时展示广告插播——前贴、中插或后贴。VAST 描述广告本身。一个 VMAP AdBreak 要么在 VASTAdData 中内嵌 VAST 文档,要么用 AdTagURI 指向一个。
- VMAP 校验器接受哪些 timeOffset 格式?
- 它识别 VMAP 的四种偏移样式:关键字 start 和 end、以 HH:MM:SS.mmm 表示的绝对时间、如 25% 的内容时长百分比,以及如 #2 的 #n 位置标记。其他任何内容都会被标为未识别的 timeOffset。
- 该工具会抓取 AdTagURI 背后的 VAST 吗?
- 不会。校验器只检查 VMAP 结构——它会识别每个 AdBreak 使用内联 VASTAdData 还是 AdTagURI,但绝不调用广告服务器或下载标签。你粘贴的任何内容都不会离开你的浏览器。
- 它如何判定某个插播是前贴、中插还是后贴?
- timeOffset 为 start 是前贴,end 是后贴,任何具体时间、百分比或 #n 位置都视为中插。时间轴按解析出的插播位对插播分组,因此 pod 顺序一目了然。
- 它能校验只有一个 AdBreak 的 VMAP 吗?
- 可以。无论你的播放列表只有一个插播还是完整的前/中/后贴 pod,每个 vmap:AdBreak 都以相同方式检查,并按排期顺序放到时间轴上,包括一个未包在列表中的单独插播。
- 为什么我的 breakType 被拒绝?
- VMAP 的 breakType 只允许 linear、nonlinear 或 display。拼写错误、VAST 素材类型或空属性都会被标记。请在 vmap:AdBreak 元素上设置有效值以清除该错误。
相关工具
- VAST 校验器 — 在浏览器中对照 IAB 规则校验 VAST XML 标签、识别版本并检查必需节点。
- VAST 标签检查器 — 解析 VAST XML,展开 InLine/Wrapper 结构、媒体文件与跟踪 URL,不触发像素。
- VAST 宏展开器 — 在跟踪 URL 中展开 IAB VAST 4.x 宏并预览触发的请求,附可搜索参考。
- VAST 错误码查询 — 查询任意 IAB VAST 或 VPAID 错误码的含义、类别与可能的修复方法。
- OpenRTB 竞价请求校验器 — 对照 IAB 规则校验 OpenRTB 2.5 与 2.6 竞价请求的必需字段与枚举码。
- ads.txt 校验器 — 逐行校验 ads.txt 或 app-ads.txt 的字段数量、DIRECT/RESELLER 关系与重复项。
全部 ArrayKit 工具