OMID 分册导航
VAST 承载
承载本页清单由 scripts/gen-omid-spec.mjs 自 IAB Tech Lab 官方源生成，描述为官方英文原文；采集基线见页尾。
定位与职责
响应侧：开放测量接口定义（Open Measurement Interface Definition，OMID）的验证脚本由 VAST 的 AdVerifications / Verification 元素承载（官方 4.0 XSD 已在 InLine 与 Wrapper 双侧声明），JavaScriptResource 以 apiFramework="omid" 标识 OMID 资源，browserOptional 属性与 VerificationParameters 元素自 4.1 起入库；宏 [VERIFICATIONVENDORS] 与 [OMIDPARTNER] 分别填充验证厂商列表与 Partner 标识（name/versionString）。视频播放器-广告接口定义（Video Player-Ad Interface Definition，VPAID）自 VAST 4.1 起弃用，其测量职责由 OMID 承接。
- 格式
- VAST 4.x
- 元素 / 属性
- AdVerifications / Verification
- 起始版本
- 4.0（browserOptional 与 VerificationParameters 自 4.1）
- 相关宏
- 4
AdVerifications 元素与属性
| 元素 / 属性 | 起始版本 | 含义 |
|---|---|---|
| VAST > Ad > {InLine | Wrapper} > AdVerifications | 4.0 | 官方 4.0 XSD 已在 InLine 与 Wrapper 双侧声明该元素；4.1 之前的存量做法是用 type 为 AdVerifications 的 Extensions 节点承载。3.0 时代也有扩展形态的 AdVerifications，站内按可容忍形态处理。ENAdded in VAST 4 so that executable code for measurement could be delivered separately from the MediaFile. |
| AdVerifications > Verification | 4.0 | 每个 Verification 元素代表一家验证厂商的资源；vendor 属性给出厂商标识，可重复出现。ENvendor attribute example in the official XSD documentation: "For example, 'company.com-omid'". |
| Verification > JavaScriptResource | 4.0 | 以 apiFramework="omid" 标识这是 OMID 验证脚本；元素正文为脚本 URI。ENapiFramework attribute; example value in official samples: apiFramework="omid". |
| JavaScriptResource@browserOptional | 4.1 | 声明该脚本在没有浏览器环境时也可执行——原生广告与无 DOM 的 JS 执行环境依赖它。官方 4.0 XSD 未声明此属性，故站内记为 4.1 起入库。ENNot declared in the official 4.0 XSD; integrated from 4.1 (OMID integration). |
| Verification > VerificationParameters | 4.1 | 承载厂商自定义参数，对应 OMID VerificationScriptResource 的 verificationParameters；与 Native 侧的 ext.verification_parameters 作用相同。ENNot declared in the official 4.0 XSD; integrated from 4.1. |
| Verification > ExecutableResource | 4.1 | 承载 VPAID 一类的可执行资源；随 VPAID 弃用而淡出，OMID 场景应使用 JavaScriptResource。ENIntegrated from 4.1 (Verification_type in the 4.1 XSD); fades out with VPAID deprecation. |
相关宏
| 名称 | 类型 | 起始版本 | 支持度 | 含义 |
|---|---|---|---|---|
| [EXTENSIONS]#30 · VAST request URIs | Array<string> | 4.1 | Optional | 4.1 之前的存量做法靠它声明播放器支持 AdVerifications 扩展。示例: AdVerifications,extensionA,extensionBENList of VAST Extensions type attribute values that the player / client supports. Can be used to indicate support for the OMID AdVerifications extension, proprietary extensions, or future standardized extensions. |
| [VERIFICATIONVENDORS]#31 · VAST request URIs | Array<string> | 4.1 | Optional | 播放器声明自己支持哪些验证厂商，取值与 Verification@vendor 同一命名空间（示例中的三家均以 -omid 结尾）。示例: moat.com-omid,ias.com-omid,doubleverify.com-omidENList of VAST Verification vendor attribute values that the player / client supports. |
| [OMIDPARTNER]#32 · All tracking pixels, VAST request URIs格式: {partner name}/{partner version} | string | 4.1 | Required (if OM is supported) | 支持 OM 时为必填。它是 OpenRTB 侧 omidpn / omidpv 两字段在 VAST 侧的合体形态，用斜杠分隔；官方明确要求取不到 partner name 时填 unknown，而不是省略。示例: Unencoded: MyIntegrationPartner/7.1 · Encoded: MyIntegrationPartner%2F7.1ENAn identifier of the OM SDK integration. This is the same as the "name" and "versionString" parameters of the OMID Partner object. This will allow creative providers to determine if the OM partner integration is acceptable. Note - This value is essential for communicating the certification status of the OMID integration. If partner ID is not shared, verification vendors will not be able to properly measure and report on this inventory. If partner name is not available, use "unknown". |
| [REASON]#47 · verificationNotExecuted tracking pixels | integer | 4.1 | Required | 验证未执行时的成因码，用在 verificationNotExecuted 追踪像素上；与 OMID 内部表示不可度量成因的 Reason 枚举不是同一套取值，勿混用。ENReason code for not executing verification. |
VPAID 弃用后的迁移
VAST 4 的目标之一是消除用 MediaFile 节点下发可执行代码（通常是 VPAID）的做法：为此增加了 AdVerifications 与 InteractiveCreativeFile，使测量用与交互用的可执行代码可与 MediaFile 分开下发。VPAID 的验证/测量职责由 OMID 接替、交互职责由 SIMID 接替。VAST 4.1 起 MediaFile 上用于下发 VPAID 的 apiFramework 属性也已弃用。
VAST 标签制作方（直接标签与包装标签）
- 1请求中已指明支持 OMID 时，包含 AdVerifications 节点（4.1 之前用 type 为 AdVerifications 的 Extensions 节点）以带上验证脚本。
- 2请求指明支持 VPAID 且标签制作方确需 VPAID（用于交互或广告阻断）时，同时包含 AdVerifications 节点与 VPAID 类型的 MediaFile 节点。
- 3OMID / VPAID 支持情况未知且买方对 VPAID 无硬性要求时，标签应同时包含三者：AdVerifications 节点、VPAID 类型的 MediaFile 节点、一个或多个非 VPAID 的视频创意 MediaFile 节点，使发布方手头资源齐备。
- 4能力信息应依据广告请求（OpenRTB 与 VAST 请求宏）给出，官方指定使用 [APIFRAMEWORKS] 宏。
发布方的执行顺序
- 1支持 OMID 时，执行 AdVerifications 节点（开放测量）与视频创意 MediaFile。
- 2不支持 OMID 但支持 VPAID、且标签中存在 VPAID MediaFile 节点时，执行 VPAID。
- 3OMID 与 VPAID 都支持时，两者都执行（AdVerifications 节点与 VPAID）。
- 4两者都不支持时，执行某个非 VPAID 的 MediaFile 节点。
官方明确上述顺序只是建议，未必适用所有情况；发布方可自行决定执行哪个 MediaFile。同时官方要求发布方与技术厂商测试上述各种组合，确保重复计数、命名空间冲突一类问题被正确处理。
VAST 合规明确排除开放测量：官方合规章节写明 Open Measurement、VPAID 与 VMAP 三个规范不在 VAST 合规范围内，因为它们彼此独立、也独立于 VAST；符合其中一个不代表符合其他，各规范的合规须分别声明。