VAST 2.0 元素目录

4.4 4.3 4.2 4.1 4.0 3.0 2.0

本版本切片：37 元素 · 17 属性

出处

IAB 官方 VAST 2.0.1 schema（vast_2.0.1.xsd，随 VAST 2.0 guideline 发布；vendor 于 xsd/2.0.xsd）

标注式元素树 × 真实示例

左侧全展开元素树（右侧数字为基数：1 / 0..1 / 1..* / 0..*）：点 ▾ 折叠/展开节点，「全部折叠」看轮廓；译文默认隐藏，「显示译文」开启；右侧真实 XML 示例；点击任一侧元素名，双侧同步高亮

<VAST>@version*0..1…+119
响应根元素，version 属性声明 VAST 版本号。
- <Ad>InLine | Wrapper 二选一@id@sequence0..*…+115
  顶层广告单元，包裹响应中的每个广告；序列广告（Ad Pod）通过 sequence 排序。
  - <InLine>0..1…+56
    完整广告数据（内联广告）：创意、追踪与元数据的完整定义。与 Wrapper 二选一。
    - <AdSystem>@version1
      广告服务器（Ad Server）标识，version 属性注明其版本。
    - <AdTitle>1
      广告标题，供广告投放系统与报表展示。
    - <Impression>uri@id1..*
      曝光（Impression）追踪地址：广告开始播放时请求，用于计数计费；可多个。
    - <Description>0..1
      广告描述文本。
    - <Survey>uri0..1
      调研问卷地址（4.1 起弃用）。
    - <Error>uri0..*
      错误上报地址：播放失败时由播放器请求，[ERRORCODE] 宏携带错误码。
    - <Creatives>1…+47
      创意集合容器。
      - <Creative>@id@sequence@AdID@apiFramework0..*…+46
        单个创意：线性（Linear）、非线性（NonLinearAds）或伴随（CompanionAds）之一。
        <Linear>0..1…+19
        线性广告（Linear Ad）：随内容时间轴播放的前贴/中贴/后贴视频广告。
        <Duration>duration1
        时长：线性广告为必填（HH:MM:SS）；非线性（4.4）在时基媒体/事件场景下必填。
        <AdParameters>0..1
        传递给创意脚本的初始化参数，xmlEncoded 注明是否 XML 编码。
        <TrackingEvents>0..1…+1
        追踪事件集合容器。
        <Tracking>uri@event*0..*
        单个追踪事件：event 指定事件名（start、quartile、complete、progress 等），文本为上报地址；progress 事件用 offset 指定时间点。
        <VideoClicks>0..1…+3
        视频点击行为容器。
        <ClickThrough>uri@id0..1
        点击跳转（ClickThrough）目标地址：用户点击广告后打开的落地页。
        <ClickTracking>uri@id0..*
        点击追踪（ClickTracking）地址：与跳转分离的点击计数上报。
        <CustomClick>uri@id0..*
        自定义点击追踪地址。
        <MediaFiles>1…+1
        媒体文件集合容器。
        <MediaFile>uri@id@delivery@type*@width*@height*@bitrate@apiFramework1..*
        可播放媒体素材地址：delivery（progressive/streaming）、MIME 类型、宽高与码率供播放器择优。
        <CompanionAds>0..1…+8
        伴随广告（Companion Ads）集合容器：与主广告同时展示的广告位。
        <Companion>@id@width*@height*@expandedWidth@expandedHeight@apiFramework0..*…+7
        单个伴随广告：独立尺寸的广告位创意（如播放器旁 300×250 横幅）。
        <StaticResource>uri@creativeType0..1
        静态资源（图片等）地址，creativeType 注明 MIME 类型。
        <IFrameResource>uri0..1
        iframe 资源地址。
        <HTMLResource>0..1
        内联 HTML 资源（直接嵌入标记）。
        <AltText>0..1
        伴随广告的替代文本（无障碍与加载失败兜底）。
        <TrackingEvents>0..1…+1
        追踪事件集合容器。
        <Tracking>uri@event*0..*
        单个追踪事件：event 指定事件名（start、quartile、complete、progress 等），文本为上报地址；progress 事件用 offset 指定时间点。
        <CompanionClickThrough>uri@id0..1
        伴随广告点击跳转地址。
        <NonLinearAds>0..1…+16
        非线性广告容器：叠加在播放内容之上、不阻断播放的广告形式。
        <NonLinear>@id@width*@height*@expandedWidth@expandedHeight@scalable@maintainAspectRatio@minSuggestedDuration@apiFramework0..*…+6
        单个非线性（NonLinear）创意：叠加图/浮层，资源为静态图/iframe/HTML；4.4 起亦支持 MediaFiles 媒体投递。
        <StaticResource>uri@creativeType0..1
        静态资源（图片等）地址，creativeType 注明 MIME 类型。
        <IFrameResource>uri0..1
        iframe 资源地址。
        <HTMLResource>0..1
        内联 HTML 资源（直接嵌入标记）。
        <TrackingEvents>0..1…+1
        追踪事件集合容器。
        <Tracking>uri@event*0..*
        单个追踪事件：event 指定事件名（start、quartile、complete、progress 等），文本为上报地址；progress 事件用 offset 指定时间点。
        <NonLinearClickThrough>uri0..1
        非线性广告点击跳转地址。
        <CompanionAds>0..1…+8
        伴随广告（Companion Ads）集合容器：与主广告同时展示的广告位。
        <Companion>@id@width*@height*@expandedWidth@expandedHeight@apiFramework0..*…+7
        单个伴随广告：独立尺寸的广告位创意（如播放器旁 300×250 横幅）。
        <StaticResource>uri@creativeType0..1
        静态资源（图片等）地址，creativeType 注明 MIME 类型。
        <IFrameResource>uri0..1
        iframe 资源地址。
        <HTMLResource>0..1
        内联 HTML 资源（直接嵌入标记）。
        <AltText>0..1
        伴随广告的替代文本（无障碍与加载失败兜底）。
        <TrackingEvents>0..1…+1
        追踪事件集合容器。
        <Tracking>uri@event*0..*
        单个追踪事件：event 指定事件名（start、quartile、complete、progress 等），文本为上报地址；progress 事件用 offset 指定时间点。
        <CompanionClickThrough>uri@id0..1
        伴随广告点击跳转地址。
        <CompanionAds>0..1…+8
        伴随广告（Companion Ads）集合容器：与主广告同时展示的广告位。
        <Companion>@id@width*@height*@expandedWidth@expandedHeight@apiFramework0..*…+7
        单个伴随广告：独立尺寸的广告位创意（如播放器旁 300×250 横幅）。
        <StaticResource>uri@creativeType0..1
        静态资源（图片等）地址，creativeType 注明 MIME 类型。
        <IFrameResource>uri0..1
        iframe 资源地址。
        <HTMLResource>0..1
        内联 HTML 资源（直接嵌入标记）。
        <AltText>0..1
        伴随广告的替代文本（无障碍与加载失败兜底）。
        <TrackingEvents>0..1…+1
        追踪事件集合容器。
        <Tracking>uri@event*0..*
        单个追踪事件：event 指定事件名（start、quartile、complete、progress 等），文本为上报地址；progress 事件用 offset 指定时间点。
        <CompanionClickThrough>uri@id0..1
        伴随广告点击跳转地址。
    - <Extensions>xs:any 任意内容0..1…+1
      扩展容器：xs:any，任意厂商自定义内容。
      - <Extension>xs:any 任意内容@type0..*
        单个扩展项，type 标识用途；4.4 起标准化 AdCOM 信令（plcmt/pos/playbackmethod/attr）。
  - <Wrapper>0..1…+55
    重定向包装器：不含创意本体，通过 VASTAdTagURI 指向下游广告服务器再次请求。与 InLine 二选一。
    - <AdSystem>@version1
      广告服务器（Ad Server）标识，version 属性注明其版本。
    - <Impression>uri@id0..*
      曝光（Impression）追踪地址：广告开始播放时请求，用于计数计费；可多个。
    - <Error>uri0..*
      错误上报地址：播放失败时由播放器请求，[ERRORCODE] 宏携带错误码。
    - <VASTAdTagURI>uri1
      Wrapper 的下游广告请求地址：播放器据此发起二次请求获取真正的创意。
    - <AdTagURI>uri≤ 2.00..1
      VASTAdTagURI 的遗留元素名，见于部分 2.0 时代文档（兼容容忍项，任何官方 XSD 均未声明）。
    - <Creatives>1…+47
      创意集合容器。
      - <Creative>@id@sequence@AdID@apiFramework0..*…+46
        单个创意：线性（Linear）、非线性（NonLinearAds）或伴随（CompanionAds）之一。
        <Linear>0..1…+19
        线性广告（Linear Ad）：随内容时间轴播放的前贴/中贴/后贴视频广告。
        <Duration>duration1
        时长：线性广告为必填（HH:MM:SS）；非线性（4.4）在时基媒体/事件场景下必填。
        <AdParameters>0..1
        传递给创意脚本的初始化参数，xmlEncoded 注明是否 XML 编码。
        <TrackingEvents>0..1…+1
        追踪事件集合容器。
        <Tracking>uri@event*0..*
        单个追踪事件：event 指定事件名（start、quartile、complete、progress 等），文本为上报地址；progress 事件用 offset 指定时间点。
        <VideoClicks>0..1…+3
        视频点击行为容器。
        <ClickThrough>uri@id0..1
        点击跳转（ClickThrough）目标地址：用户点击广告后打开的落地页。
        <ClickTracking>uri@id0..*
        点击追踪（ClickTracking）地址：与跳转分离的点击计数上报。
        <CustomClick>uri@id0..*
        自定义点击追踪地址。
        <MediaFiles>1…+1
        媒体文件集合容器。
        <MediaFile>uri@id@delivery@type*@width*@height*@bitrate@apiFramework1..*
        可播放媒体素材地址：delivery（progressive/streaming）、MIME 类型、宽高与码率供播放器择优。
        <CompanionAds>0..1…+8
        伴随广告（Companion Ads）集合容器：与主广告同时展示的广告位。
        <Companion>@id@width*@height*@expandedWidth@expandedHeight@apiFramework0..*…+7
        单个伴随广告：独立尺寸的广告位创意（如播放器旁 300×250 横幅）。
        <StaticResource>uri@creativeType0..1
        静态资源（图片等）地址，creativeType 注明 MIME 类型。
        <IFrameResource>uri0..1
        iframe 资源地址。
        <HTMLResource>0..1
        内联 HTML 资源（直接嵌入标记）。
        <AltText>0..1
        伴随广告的替代文本（无障碍与加载失败兜底）。
        <TrackingEvents>0..1…+1
        追踪事件集合容器。
        <Tracking>uri@event*0..*
        单个追踪事件：event 指定事件名（start、quartile、complete、progress 等），文本为上报地址；progress 事件用 offset 指定时间点。
        <CompanionClickThrough>uri@id0..1
        伴随广告点击跳转地址。
        <NonLinearAds>0..1…+16
        非线性广告容器：叠加在播放内容之上、不阻断播放的广告形式。
        <NonLinear>@id@width*@height*@expandedWidth@expandedHeight@scalable@maintainAspectRatio@minSuggestedDuration@apiFramework0..*…+6
        单个非线性（NonLinear）创意：叠加图/浮层，资源为静态图/iframe/HTML；4.4 起亦支持 MediaFiles 媒体投递。
        <StaticResource>uri@creativeType0..1
        静态资源（图片等）地址，creativeType 注明 MIME 类型。
        <IFrameResource>uri0..1
        iframe 资源地址。
        <HTMLResource>0..1
        内联 HTML 资源（直接嵌入标记）。
        <TrackingEvents>0..1…+1
        追踪事件集合容器。
        <Tracking>uri@event*0..*
        单个追踪事件：event 指定事件名（start、quartile、complete、progress 等），文本为上报地址；progress 事件用 offset 指定时间点。
        <NonLinearClickThrough>uri0..1
        非线性广告点击跳转地址。
        <CompanionAds>0..1…+8
        伴随广告（Companion Ads）集合容器：与主广告同时展示的广告位。
        <Companion>@id@width*@height*@expandedWidth@expandedHeight@apiFramework0..*…+7
        单个伴随广告：独立尺寸的广告位创意（如播放器旁 300×250 横幅）。
        <StaticResource>uri@creativeType0..1
        静态资源（图片等）地址，creativeType 注明 MIME 类型。
        <IFrameResource>uri0..1
        iframe 资源地址。
        <HTMLResource>0..1
        内联 HTML 资源（直接嵌入标记）。
        <AltText>0..1
        伴随广告的替代文本（无障碍与加载失败兜底）。
        <TrackingEvents>0..1…+1
        追踪事件集合容器。
        <Tracking>uri@event*0..*
        单个追踪事件：event 指定事件名（start、quartile、complete、progress 等），文本为上报地址；progress 事件用 offset 指定时间点。
        <CompanionClickThrough>uri@id0..1
        伴随广告点击跳转地址。
        <CompanionAds>0..1…+8
        伴随广告（Companion Ads）集合容器：与主广告同时展示的广告位。
        <Companion>@id@width*@height*@expandedWidth@expandedHeight@apiFramework0..*…+7
        单个伴随广告：独立尺寸的广告位创意（如播放器旁 300×250 横幅）。
        <StaticResource>uri@creativeType0..1
        静态资源（图片等）地址，creativeType 注明 MIME 类型。
        <IFrameResource>uri0..1
        iframe 资源地址。
        <HTMLResource>0..1
        内联 HTML 资源（直接嵌入标记）。
        <AltText>0..1
        伴随广告的替代文本（无障碍与加载失败兜底）。
        <TrackingEvents>0..1…+1
        追踪事件集合容器。
        <Tracking>uri@event*0..*
        单个追踪事件：event 指定事件名（start、quartile、complete、progress 等），文本为上报地址；progress 事件用 offset 指定时间点。
        <CompanionClickThrough>uri@id0..1
        伴随广告点击跳转地址。
    - <Extensions>xs:any 任意内容0..1…+1
      扩展容器：xs:any，任意厂商自定义内容。
      - <Extension>xs:any 任意内容@type0..*
        单个扩展项，type 标识用途；4.4 起标准化 AdCOM 信令（plcmt/pos/playbackmethod/attr）。
  - <Extensions>xs:any 任意内容0..1…+1
    扩展容器：xs:any，任意厂商自定义内容。
    - <Extension>xs:any 任意内容@type0..*
      单个扩展项，type 标识用途；4.4 起标准化 AdCOM 信令（plcmt/pos/playbackmethod/attr）。
- <Error>uri≤ 3.00..1
  错误上报地址：播放失败时由播放器请求，[ERRORCODE] 宏携带错误码。
- <Extensions>xs:any 任意内容0..1…+1
  扩展容器：xs:any，任意厂商自定义内容。
  - <Extension>xs:any 任意内容@type0..*
    单个扩展项，type 标识用途；4.4 起标准化 AdCOM 信令（plcmt/pos/playbackmethod/attr）。

教学基准样例（VAST 4.2）：覆盖 InLine 主链全要素；值为演示性质，结构严格对齐官方 4.2 XSD

<?xml version="1.0" encoding="UTF-8"?>
<VAST version="4.2">
  <Ad id="ortb-demo-001" sequence="1">
    <InLine>
      <AdSystem version="2.0">ortb.cn demo server</AdSystem>
      <AdTitle>ORTB 演示：15 秒可跳过贴片</AdTitle>
      <Impression id="imp-main"><![CDATA[https://example.com/impression?aid=ortb-demo-001]]></Impression>
      <Category authority="https://www.iabtechlab.com/category-list">IAB1-7</Category>
      <Advertiser id="adv-1001">ORTB Demo Advertiser</Advertiser>
      <Description>演示用 InLine 线性广告，覆盖 VAST 4.2 主链要素。</Description>
      <Error><![CDATA[https://example.com/error?[ERRORCODE]]]></Error>
      <ViewableImpression id="vi-1">
        <Viewable><![CDATA[https://example.com/viewable]]></Viewable>
        <NotViewable><![CDATA[https://example.com/notviewable]]></NotViewable>
        <ViewUndetermined><![CDATA[https://example.com/viewundetermined]]></ViewUndetermined>
      </ViewableImpression>
      <UniversalAdId idRegistry="ad-id.org">8465-1234-5678</UniversalAdId>
      <AdServingId>a5f3c2d1-0000-4e2b-9c1d-demo00000001</AdServingId>
      <AdVerifications>
        <Verification vendor="omid-demo">
          <JavaScriptResource apiFramework="omid" browserOptional="true"><![CDATA[https://example.com/omid.js]]></JavaScriptResource>
          <VerificationParameters><![CDATA[{"partner":"demo"}]]></VerificationParameters>
          <TrackingEvents>
            <Tracking event="verificationNotExecuted"><![CDATA[https://example.com/om-fail?[REASON]]]></Tracking>
          </TrackingEvents>
        </Verification>
      </AdVerifications>
      <Creatives>
        <Creative id="cr-1" adId="8465-1234-5678" sequence="1">
          <UniversalAdId idRegistry="ad-id.org">8465-1234-5678</UniversalAdId>
          <Linear skipoffset="00:00:05">
            <Duration>00:00:15</Duration>
            <AdParameters xmlEncoded="false"><![CDATA[{"title":"demo"}]]></AdParameters>
            <TrackingEvents>
              <Tracking event="creativeView"><![CDATA[https://example.com/t?e=creativeView]]></Tracking>
              <Tracking event="start"><![CDATA[https://example.com/t?e=start]]></Tracking>
              <Tracking event="firstQuartile"><![CDATA[https://example.com/t?e=firstQuartile]]></Tracking>
              <Tracking event="midpoint"><![CDATA[https://example.com/t?e=midpoint]]></Tracking>
              <Tracking event="thirdQuartile"><![CDATA[https://example.com/t?e=thirdQuartile]]></Tracking>
              <Tracking event="complete"><![CDATA[https://example.com/t?e=complete]]></Tracking>
              <Tracking event="progress" offset="00:00:10"><![CDATA[https://example.com/t?e=progress10]]></Tracking>
              <Tracking event="skip"><![CDATA[https://example.com/t?e=skip]]></Tracking>
            </TrackingEvents>
            <MediaFiles>
              <MediaFile id="mf-720" delivery="progressive" type="video/mp4" width="1280" height="720" bitrate="2500" codec="H.264" scalable="true" maintainAspectRatio="true"><![CDATA[https://example.com/media/720p.mp4]]></MediaFile>
              <MediaFile id="mf-1080" delivery="progressive" type="video/mp4" width="1920" height="1080" bitrate="5000" codec="H.264"><![CDATA[https://example.com/media/1080p.mp4]]></MediaFile>
              <Mezzanine delivery="progressive" type="video/mp4" width="3840" height="2160" codec="H.264"><![CDATA[https://example.com/media/mezzanine.mp4]]></Mezzanine>
            </MediaFiles>
            <VideoClicks>
              <ClickThrough id="ct-1"><![CDATA[https://example.com/landing]]></ClickThrough>
              <ClickTracking id="ctr-1"><![CDATA[https://example.com/t?e=click]]></ClickTracking>
            </VideoClicks>
            <Icons>
              <Icon program="AdChoices" width="18" height="18" xPosition="right" yPosition="top" type="image/png">
                <StaticResource creativeType="image/png"><![CDATA[https://example.com/adchoices.png]]></StaticResource>
                <IconClicks>
                  <IconClickThrough><![CDATA[https://example.com/adchoices-info]]></IconClickThrough>
                </IconClicks>
              </Icon>
            </Icons>
          </Linear>
        </Creative>
        <Creative id="cr-2" sequence="2">
          <CompanionAds>
            <Companion id="comp-300x250" width="300" height="250" assetWidth="300" assetHeight="250" expandedWidth="300" expandedHeight="250">
              <StaticResource creativeType="image/jpeg"><![CDATA[https://example.com/companion.jpg]]></StaticResource>
              <AltText>ORTB 演示伴随广告</AltText>
              <CompanionClickThrough><![CDATA[https://example.com/companion-landing]]></CompanionClickThrough>
            </Companion>
          </CompanionAds>
        </Creative>
      </Creatives>
      <Extensions>
        <Extension type="demo-note">演示数据：ortb.cn 协议页示例</Extension>
      </Extensions>
    </InLine>
  </Ad>
</VAST>