a
注意：XML 摘要响应应符合 VAST 2.0 规范。支持 VAST 2.0 或更高版本。详细了解 VAST 2.0
Google 提供帮助中心内容的翻译版本，但我们政策的内容不会因此而改变。英语版是我们在执行政策时所依据的官方语言版本。要查看本文的其他语言版本，请使用页面底部的语言下拉列表。
| 元素 | 属性 | 值 | 必需 | 支持 | 备注 |
|---|---|---|---|---|---|
| VAST | 根节点 | 是 | 是 | ||
| version | 字符串（2.0 及更高版本） | 是 | 是 | 必须支持 2.0 及更高版本 | |
| - Ad | id - 唯一标识符 | 字符串 | 是 | 是 | 顶级元素用于封装响应中的各个广告 |
| -- InLine | 无 | 无 | 是 | 是 | 周边次级元素用于完成单个广告的广告数据 |
| --- AdSystem | Company Node Name | 字符串 | 是 | 是 | 表明来源广告服务器 |
| version | 字符串 | 推荐 | 是 | 广告系统使用的内部版本 | |
| --- AdTitle | 无 | 字符串 | 否 | 是 | 广告的常用名称 |
| --- Description | 无 | 字符串 | 否 | 是 | 广告的详细说明 |
| --- Survey | 无 | URI | 否 | 否 | 用于调查供应商的请求 URI（Google 仅支持调查用跟踪像素。这可以按 Impression 元素在 In-Line 节点中实施。） |
| --- Error | 无 | URI | 否 | 是 | 在广告因出错而未播放时请求的 URI（Google 仅会在出错时针对相应 URI 执行请求，而不会传递额外的错误信息。） |
| --- Impression | 无 | URI | 是 | 是 | 用于跟踪展示的 URI |
| --- Creatives | 无 | 无 | 是 | 是 | 包含一个或多个广告素材的容器 |
| ---- Creative | 是 | 是 | 封装各个广告元素 | ||
| id | 字符串 | 否 | 是 | 可选标识符 | |
| sequence | 整数 | 否 | 是 | 在有多个 Creatives 可展示时的首选顺序 | |
| AdID | 字符串 | 否 | 是 | 广告的 ID（以前称为 ISCI） | |
| ----- Linear | 是 | 是 | |||
| ------ Duration | 无 | 时间 | 是 | 是 | |
| ------ TrackingEvents | 否 | 否 | |||
| ------- Tracking | URI | 否 | 否 | 用于跟踪播放过程中的各种事件的 URI | |
| 事件 | creativeView, start, firstQuartile, midpoint, thirdQuartile, complete, mute, unmute, pause, rewind, resume, fullscreen, expand, collapse, acceptInvitation, close |
是（仅适用于 start、firstQuartile、midpoint、thirdQuartile、complete、mute、unmute、pause、resume、skip [如果是可跳过的插播广告]） | 是（仅适用于 start、firstQuartile、midpoint、thirdQuartile、complete、mute、unmute、pause、resume、skip [如果是可跳过的插播广告]） | 要针对 Linear 元素跟踪的事件的名称。应始终请求广告观看次数（如果有）。 | |
| ------ AdParameters | 字符串 | 否 | 否 | 要传入视频广告的数据。 | |
| ------ VideoClicks | 是 | 是 | |||
| ------- ClickThrough | 无 | URI | 是 | 是 | 在用户点击视频时作为目标网页打开的 URI |
| ------- ClickTracking | URI | 否 | 是 | 在用户点击视频时为进行跟踪而请求的 URI | |
| ------- CustomClick | URI | 否 | 是 | 针对热门视频等自定义事件请求的 URI | |
| id | 字符串 | 否 | 否 | 可选标识符 | |
| ------ MediaFiles | 是 | 是 | |||
| ------- MediaFile | URI | 是 | 是 | 线性文件的位置 | |
| delivery | progressive | 是 | 是 | 广告的投放方法（Google 不建议采用流式传输） | |
| type | 字符串 | 是 | 是 | MIME 类型（适用于 Windows Media 的热门 MIME 类型为“video/x-ms-wmv”） | |
| bitrate | 整数 | 是 | 是 | 编码视频的比特率（以 Kbps 为单位） | |
| width | 整数 (480) | 是 | 是 | 视频的像素尺寸 | |
| height | 整数 (360) | 是 | 是 | 视频的像素尺寸 | |
| scalable | 布尔值 | 否 | 否 | 广告是否接受图片比例调整（Google 默认情况做法） | |
| maintainAspectRatio | 布尔值 | 否 | 是 | 无论为该属性设置何值，Google 的播放器都将始终保持既定宽高比。 | |
| apiFramework | 字符串 | 否 | 否 | apiFramework 用于定义通信方法（如果 MediaFile 是交互式类型）。 | |
| ----- CompanionAds | 否 | 是 | 目前仅 Google Ads 支持随播横幅广告。Google Ad Manager 目前不支持该广告格式。 | ||
| ------ Companion | 否 | 是 | 任意数量的随播广告，且不限像素尺寸。 | ||
| id | 字符串 | 否 | 是 | 可选标识符 | |
| width | 整数 (300) | 是（如果投放随播广告） | 是 | 随播广告的像素尺寸（我们接受 300x250 和 300x60 的随播广告） | |
| height | 整数（60 或 250） | 是（如果投放随播广告） | 是 | 随播广告的像素尺寸（我们接受 300x250 和 300x60 的随播广告） | |
| expandedWidth | 整数 | 否 | 否 | 展开式随播广告在处于展开状态时的像素尺寸（Google 上的视频插播广告不支持展开功能） | |
| expandedHeight | 整数 | 否 | 否 | 展开式随播广告在处于展开状态时的像素尺寸（Google 上的视频插播广告不支持展开功能） | |
| apiFramework | 字符串 | 否 | 否 | apiFramework 用于定义与随播广告之间的通信方法 | |
| ------- StaticResource | URI | 否 | 是 | 指向图片或 SWF 文件等静态文件的 URI | |
| creativeType | 字符串 | 是（如果使用静态资源投放随播广告） | 是 | 静态资源的 MIME 类型 | |
| ------- IFrameResource | 无 | URI | 否 | 是 | IFrame 用于展示随播元素的 URI 源 |
| ------- HTMLResource | 无 | CDATA | 否 | 否 | 用于展示随播元素的 HTML |
| ------- JavaScriptResource | 无 | CDATA | 否 | 否 | 用于展示随播元素的 JavaScript |
| ------- TrackingEvents | 否 | 否 | |||
| -------- Tracking | URI | 否 | 否 | 用于展示随播元素的 URI | |
| 事件 | creativeView | 是（如果投放随播广告） | 否 | 应始终请求广告观看次数（如果有）。对于随播广告来说，广告观看次数是其唯一支持的活动。 | |
| ------- CompanionClickThrough | 无 | URI | 否（如果是在不采用 硬编码的点击后到达网址 的情况下投放静态图片，则为是） |
是 | 在用户点击随播广告时作为目标网页打开的 URI（SWF 广告使用适当大小写形式的 clickTAG） |
| ------- AltText | 无 | 字符串 | 否 | 是 | 当随播广告在 HTML 环境中投放时显示的替代文字 |
| ------- AdParameters | 字符串 | 否 | 否 | 要传入随播广告的数据 | |
| ----- NonLinearAds | 否 | 否 | 目前尚不支持（仅限线性视频插播广告） | ||
| --- Extensions | 否 | 否 | |||
| ---- Extension | type | 任何值 | 否 | 否 | 可能包含在扩展程序节点中的任何有效 XML。 |
| - Wrapper | 无 | 无 | 否 | 否（仅通过 Google Ad Manager 允许使用的 2 个封装工具除外） | 围绕封装工具并指向备用广告服务器的次级元素 |