VMAP 用一组带时间偏移与类型的广告断点描述视频节目内的广告库存结构;断点内的广告必须由 VAST 或其他广告模板提供。
分册导航
协议本体总览
本域协议本体的分册总入口:文档结构、播放与错误、合规与示例三组逐章展开,覆盖根元素到错误码的全部机器可读结构。
共 12 章 · live 12 · draft 0 · planned 0
文档结构
5 章单个广告断点:timeOffset 决定何时插、breakType 决定能插什么类型,另可带 breakId 与 repeatAfter。
断点的广告来源:内联 VASTAdData、引用 AdTagURI、或非 VAST 的 CustomAdData,三选一。
断点级追踪:breakStart / breakEnd / error 三个事件;与 VAST 同名但属不同规范,须以命名空间区分。
扩展点:断点级与顶层 Extensions 承载 VMAP 未定义的信息;XML 注释允许出现在文档任意位置。
播放与错误
3 章播放器如何执行断点:按 breakType 期望广告类型、多值时的优先顺序、nonlinear 重叠与 display 的可见性约束。
两类错误(VMAP 执行 / 广告响应执行)都触发 error 追踪;[ERROR_CODE] 与 [ERROR_MESSAGE] 宏必须替换,错误码取 900 与 1000–1008。
没有任何断点时,响应只保留根 VMAP 元素——这是合法的「本次无广告」表达,不是错误。
合规与示例
3 章合规分两侧:广告服务器守 schema 与跨域取回;播放器以 VAST 3.0 与 Ad Pod 格式为前提,三类断点按能力上限支持。
逐条可核对的合规清单:广告服务器两条、播放器三条(含能力上限例外)。
官方 §5 示例:pre-roll / mid-roll / post-roll 三个 linear 断点,均内联 VAST 3.0 并带 breakStart 追踪。