您可以使用 YouTube VAST 质量检查工具来验证您的 VAST 广告代码是否符合我们的第三方广告投放规范。您还可以使用此工具在 YouTube 播放器上轻松预览第三方投放的视频广告。
已获批准的第三方供应商
第三方插播广告及其随播横幅广告必须使用 YouTube 批准的 VAST 供应商提供的线性 VAST 代码。请注意,如果发现第三方投放的广告违反了我们的广告政策,我们可能会限制或暂停投放这些广告。请参阅下方内容详细了解 XML 摘要。
针对 VAST 广告服务器响应的视频插播广告 XML 摘要
元素 | 属性 | 值 | 必需 | 支持 | 备注 |
---|---|---|---|---|---|
VAST | 根节点 | 是 | 是 | ||
version | 字符串 (3.0) | 是 | 是 | 必须支持任何 VAST 2.* 或 3.0 版 | |
广告 | ID | 字符串 | 是 | 是 | 顶级元素用于封装响应中的各个广告 |
InLine | 无 | 无 | 是 | 是 | 周边次级元素用于完成单个广告的广告数据 |
AdSystem | 无 | 字符串 | 是 | 是 | 表明来源广告服务器 |
version | 字符串 | 推荐 | 是 | 广告系统使用的内部版本 | |
AdTitle | 无 | 字符串 | 否 | 是 | 广告的常用名称 |
Description | 无 | 字符串 | 否 | 是 | 广告的详细说明 |
Survey | 无 | URI | 否 | 否 | 用于调查供应商的请求 URI(YouTube 仅在此节点中支持来自认证调查供应商的调查用跟踪像素。目前不允许通过 VAST XML 提供问卷调查或问卷调查邀请。) |
错误 | 无 | URI | 否 | 是 | 在广告因出错而无法播放时请求的 URI。YouTube 只会在出错时向相应的 URI 发出请求,但不会传递额外的错误信息。 |
展示 | 无 | URI | 是 | 是 | 用于跟踪展示的 URI |
Creatives | 无 | 无 | 是 | 是 | 包含一个或多个广告素材的容器 |
Creative | 是 | 是 | 封装各个广告元素 | ||
ID | 字符串 | 否 | 是 | 可选标识符 | |
sequence | 整数 | 否 | 是 | 在有多个 Creatives 可展示时的首选顺序 | |
AdID | 字符串 | 否 | 是 | 广告 ID(以前称为 ISCI) | |
Linear | 是 | 是 | |||
skipoffset | 00:00:05 | 否 | 是 | 仅限 VAST 3.0 | |
Duration | 无 | 时间 | 是 | 是 | |
TrackingEvents | 否 | 是 | |||
Tracking | URI | 否 | 是 | 用于跟踪播放过程中的各种事件的 URI | |
event | creativeView, start, firstQuartile, midpoint, thirdQuartile, complete, mute, unmute, pause, rewind, resume, fullscreen, expand, collapse, acceptInvitation, close acceptInvitationLinear closeLinear progress skip |
否 |
是 (仅适用于 start、firstQuartile、midpoint、thirdQuartile、complete)。仅 VAST 3.0 支持 Skip |
要针对 Linear 元素跟踪的事件的名称。应始终请求广告观看次数(如果有)。 | |
AdParameters | 字符串 | 否 | 否 | 要传入视频广告的数据。 | |
VideoClicks | 是 | 是 | |||
ClickThrough | 无 | URI | 是 | 是 | 在观看者点击视频时作为目标网页打开的 URI |
ClickTracking | URI | 否 | 是 | 在观看者点击视频时为进行跟踪而请求的 URI | |
CustomClick | URI | 否 | 是 | 针对热门视频等自定义事件请求的 URI | |
ID | 字符串 | 否 | 否 | 可选标识符 | |
MediaFiles | 是 | 是 | |||
MediaFile | URI |
是 (必须至少加入 2 个独立的 MediaFile 节点,每个 MP4 和 WebM 视频格式各一个) |
是 | 线性文件的位置 | |
delivery | progressive | 是 | 是 | 广告的投放方法(YouTube 不建议采用流式传输) | |
type | 字符串 | 是(MP4 和 WebM) | 是 | MIME 类型(适用于 Windows Media 的热门 MIME 类型包括但不限于“video/x-ms-wmv”) | |
bitrate | 整数 | 是 | 是 | 编码视频的比特率(以 Kbps 为单位) | |
width | 整数 (480) | 是 | 是 | 视频的像素尺寸 | |
height | 整数 (360) | 是 | 是 | 视频的像素尺寸 | |
scalable | 布尔值 | 否 | 否 | 广告是否接受图片比例调整(YouTube 默认情况做法)。 | |
maintainAspectRatio | 布尔值 | 否 | 是 | ||
apiFramework | 字符串 | 否 | 否 | 如果 MediaFile 的类型为交互式,apiFramework 会指定通信方法。 | |
CompanionAds | 否 | 是 | |||
Companion | 否 | 是 | 任意数量的随播广告,且不限像素尺寸。 | ||
ID | 字符串 | 否 | 是 | 可选标识符 | |
width | 整数 (300) | 是(如果投放随播广告) | 是 | 随播广告的像素尺寸 | |
height | 整数 (60) | 是(如果投放随播广告) | 是 | 随播广告的像素尺寸 | |
expandedWidth | 整数 | 否 | 否 | 展开式随播广告在处于展开状态时的像素尺寸(YouTube 上的视频插播广告不支持展开功能) | |
expandedHeight | 整数 | 否 | 否 | 展开式随播广告在处于展开状态时的像素尺寸(YouTube 上的视频插播广告不支持展开功能) | |
apiFramework | 字符串 | 否 | 否 | apiFramework 用于定义与随播广告之间的通信方法 | |
StaticResource | URI | 否 | 是 | 指向图片等静态文件的 URI。 | |
creativeType | 字符串 | 是(如果使用静态资源投放随播广告) | 是 | Mime 类型的静态资源,仅支持图片类型 | |
IFrameResource | 无 | URI | 否 | 是 | IFrame 用于展示随播元素的 URI 源 |
HTMLResource | 无 | CDATA | 否 | 否 | 用于展示随播元素的 HTML |
JavaScriptResource | 无 | CDATA | 否 | 否 | 用于展示随播元素的 JavaScript |
TrackingEvents | 否 | 否 | |||
Tracking | URI | 否 | 否 | 用于展示随播元素的 URI | |
event | creativeView | 是(如果投放随播广告) | 否 | 应始终请求广告观看次数(如果有)。对于随播广告来说,广告观看次数是其唯一支持的活动。 | |
CompanionClickThrough | 无 | URI | 是(如果要在不采用硬编码的点击后到达网址的情况下 投放静态图片) |
是 | 在观看者点击随播广告时作为目标网页打开的 URI。 |
AltText | 无 | 字符串 | 否 | 是 | 当随播广告在 HTML 环境中投放时显示的替代文字 |
AdParameters | 字符串 | 否 | 否 | 要传入随播广告的数据 | |
NonLinearAds | 否 | 否 | 目前尚不支持(仅限线性视频插播广告) | ||
Extensions | 否 | 否 | |||
Extension | type | 任何值 | 否 | 否 | 可能包含在扩展程序节点中但会被忽略的任何有效 XML。 |
Wrapper | 无 | 无 | 否 | 否 | 围绕封装工具并指向备用广告服务器的次级元素 |