视频广告投放模板 (VAST) 是用于将广告投放到数字视频播放器的通用 XML 架构。Unity 支持 VAST 4.0(由美国互联网广告局 (IAB) 开发和维护的标准),并且向后兼容 2.0(部分功能除外)。
Unity SDK 会解析 VAST XML 以获取视频媒体文件和追踪 URL。
请确保遵循这些要求:
- VAST
<InLine>
必须包含展示视频广告所需的所有必填元素。如需了解更多信息,请参阅 VAST 指南的第 3.4 节。 - 受支持的
<MediaFile>
类型包括video/mp4
和video/webm
。应包括bitrate
,delivery
,width
和height
属性。如需了解更多信息,请参阅 VAST 指南的第 3.9 节。 - 视频时长必须在 5 到 30 秒之间。
- 最多可以将 VAST 标签封装五次。
- 在初始视频广告结束或跳过后,结束页广告必须全屏展示。
- 所有 HTML 标记必须使用包含
https://
和域名的绝对 URL 路径引用外部托管资源。从file://
或相对 URL 路径指向资源不起作用。
请提供不同规格的视频文件,以适应不同的环境:
- 视频文件大小的上限为 20 MB。
- 采用 WIFI 连接时,视频播放器将选择大小为 5-10 MB 之间的视频文件。
- 采用蜂窝网络连接时,视频播放器将选择大小为 0.5-3 MB 之间的视频文件。
- 尽可能针对竖屏/横屏模式提供相应规格的视频文件。
可跳过视频广告
开发者可以决定用户是否可以跳过其应用内的视频广告。大多数的可跳过广告,均会要求用户观看广告开头的固定几秒后(具体时间由开发者决定)才可跳至结束页。由于大多数的可跳过广告允许用户直接跳至结束页,Unity 强烈建议您为视频广告添加结束页。欲了解更多关于可跳过与不可跳过视频广告流量,可联系您的客户经理。
视频控件
Unity 的视频控件覆盖层将在视频播放时渐入视野。用户可以通过点击屏幕隐藏或再次显示它。此覆盖层包括屏幕底部的进度条, 隐私图标和行动号召按钮 (CTA)。可能包括右上角的关闭按钮或左上角的跳过图标。
视频点击支持
VAST 标签必须在 <ClickThrough>
节点中包含单个视频点击跳转链接,并可以在各自的 <ClickTracking>
节点中包含多个点击追踪链接。如需了解更多信息,请参阅 VAST 指南的第 3.10 节。
请确保遵循这些要求:
- 点击跳转 URL 应在各自平台上使用
https://
,market://
,itunes://
或itms://
前缀。 - Unity 强烈建议使用服务器端重定向/跳转,而不是附加冗长的链接。
- Unity 不支持采用
tel://
前缀的点击呼叫广告。 - 点击包装器可以包含额外的点击追踪。
视频行动号召按钮 (CTA)
在视频播放过程中,屏幕右下角会出现一个行动号召按钮 (CTA)。用户必须点击按钮才能触发点击事件并打开 <ClickThrough>
URL。行动号召按钮 (CTA) 默认显示为"Learn More(了解更多)"。如果广告素材的广告返回中存在 Bundle ID,则行动号召按钮 (CTA) 将显示"Install Now(立即安装)"。


行动号召按钮 (CTA) 图标
VAST 3.0 及更高版本支持使用该图标。如果广告返回中包含 Bundle ID,则在视频播放期间,Unity 视频播放器会在"Install Now(立即安装)"按钮旁边显示一个方形图标。您可以在 VAST 标签中嵌套自定义图标。如需了解更多信息,请参阅 VAST 指南的第 3.11 节。
图标应能代表所推广的应用或游戏。Unity 不支持在视频上显示任何其他的图标。请确保遵循这些图标要求:
- 图标应该是
<StaticResource>
图像,带有.png
,.jpg
或.jpeg
扩展名。 - 图标将显示为 25 x 25 像素的正方形。
- Unity 不支持图标持续时间和
<IconClickThrough>
功能。
行动号召按钮 (CTA) 图标代码示例
<Icons> <Icon width="25" height="25"> <StaticResource creativeType="image/png"> <![CDATA[ https://Unity.com/DSP/square_icon_name ]]> </StaticResource> </Icon> </Icons>
所有结束页广告都应包含符合以下尺寸要求的 height
和 width
属性:
- 正方形广告:最小宽/高均为 200 像素。
- 横屏广告:最小宽/高为 480 x 320 像素。
- 竖屏广告:最小宽/高为 320 x 480 像素。
结束页广告
视频播放完毕后,VAST 结束页广告以全屏结束页的形式出现。推荐的最佳实践是使用结束页广告来最大限度提高点击率。大多数发布者都允许跳到结束页,因此即使是可跳过的广告库存也会在用户退出广告体验之前显示结束页。
结束页广告点击支持
在展示结束页后,用户可以点击屏幕上的任意位置来触发事件 <CompanionClickTracking>
和 <CompanionClickThrough>
。结束页上不放置 Unity 行动号召按钮 (CTA)。
如需了解更多信息,请参阅 VAST 指南的第 3.13 节。
结束页资源类型
类型 | 描述 | 注意事项 |
---|---|---|
<HTMLResource> | HTML 标记。 |
|
<StaticResource> | 要在 |
|
<IframeResource> | 在 iframe 中被用作 |
|
支持的 VAST 4.x 宏
以下列表详细介绍了 Unity 支持的 VAST 4.x 宏(如果跟踪 URL 中提供了这些宏):
[ERRORCODE]
- 请参阅错误代码。
[OMIDPARTNER]
- OM SDK 集成的标识符。
- 这与
OMIDPartner
对象中的name
和versionString
参数相同。
[REASON]
- 无法执行验证的原因代码。
[TIMESTAMP]
- (时间戳)
[IFA]
- 来自针对特定设备的广告 ID 方案的可重置广告 ID,如 Apple 的广告商 ID 或 Android 的广告商 ID,采用 UUID 格式或基于 Guidelines For Identifier For Advertising On OTT Platforms(OTT 平台广告标识符指南)中的 IAB 文档。
[IFATYPE]
- 一个字符串值,表示
[IFA]
宏中包含的 IFA 类型。
- 一个字符串值,表示
[APIFRAMEWORKS]
- 播放器支持的框架列表。
- 这些值在 AdCOM 1.0 API 框架列表中定义。
[APPBUNDLE(required)]
- 对于APP类的广告,此为针对特定平台的应用程序标识符, 包名或软件包名称。该标识符不能是应用商店 ID,如 Apple App Store ID。
- 根据 VAST 4.x 宏中的 IAB 文档的第 6.1 节所述,在需要且适用但未知或不可用的情况下,设为 -1 或 -2。
- 如果需要但不适用(例如在某一APP应用中),则设为 0。
如需了解更多信息,请参阅有关 VAST 4.x 宏的文档。
故障排除
较少的展示量
如果您觉得特定视频广告系列或广告素材的竞胜率较高但展示量相对较少,请考虑以下情况:
原因 | 建议操作 |
---|---|
封装后的 VAST 标签指向一个不返回任何 XML 的 | 检查广告系列的状态为已开启。收到后的素材媒体文件最多会缓存两个小时。 |
视频文件太大 | 至少提供一个小于 20 MB 的媒体文件。 |
平台或移动端浏览器无法播放媒体文件。 | 验证媒体文件和追踪 URL 是否是安全协议 HTTPS。在 URL 末尾包含文件扩展名,例如 |
点击跳转链接
如果视频点击跳转 URL 在查询字符串中包含正斜杠 (/
) 或加号 (+
),这些符号将使用对应的 UTF-8 格式进行 URL 编码。这样就可能会干扰某些点击重定向并导致展示量减少。
字符 | UTF-8 代码 |
---|---|
/ | %2F |
+ | %2B |
例如:
https://domain.com/anything_here_is_fine?this_is_a/query+string
编码为:
https://domain.com/anything_here_is_fine?this_is_a%2Fquery%2Bstring
如果您的点击跳转链接包含特殊字符,请确保这些字符在经过 Unity 的编码后仍然有效(可正确解析或重定向)。
错误代码
Unity 将 VAST 故障发送到 VAST 标签的 <Error>
追踪 URL,并将 [ERRORCODE]
宏替换为以下错误代码之一。这些错误发生在广告即将展示或已经展示时。
代码 | 描述 |
---|---|
100 | XML 解析错误。 |
101 | VAST 架构验证错误。 |
102 | 不受支持的 VAST 版本。 |
200 | 不受支持的 VAST 格式。 |
202 | 视频时长过长或格式不是 |
300 | 封装错误。 |
301 | 一个 |
302 | 超出封装层数上限(五个)。 |
303 | 解包后未找到 |
401 | 未找到支持的媒体文件。 |
402 | 媒体文件 URI 超时。 |
403 | 不支持的媒体文件。 |
404 | 媒体文件 URI 在 iOS 上不受支持。 |
499 | 无点击跳转 URL。 |
600 | 常规结束页广告错误。 |
601 | 不支持该结束页广告尺寸。 |
602 | 无法显示结束页广告。 |
603 | 无法获取结束页广告资源。 |
604 | 未找到有效的结束页广告资源链接。 |
699 | 结束页广告未包含有效的点击跳转链接。 |
900 | 未定义的错误。 |
998 | VAST XML 内容包含无效的链接。 |
999 | 未知错误。 |