视频广告

Read time 8 minutes

视频广告投放模板 (VAST) 是用于将广告投放到数字视频播放器的通用 XML 架构。Unity 支持 VAST 4.0(由美国互联网广告局 (IAB) 开发和维护的标准),并且向后兼容 2.0(部分功能除外)。

Unity SDK 会解析 VAST XML 以获取视频媒体文件和追踪 URL。

请确保遵循这些要求:

  • VAST <InLine> 必须包含展示视频广告所需的所有必填元素。如需了解更多信息,请参阅 VAST 指南第 3.4 节
  • 受支持的 <MediaFile> 类型包括 video/mp4video/webm。应包括 bitrate, delivery, widthheight 属性。如需了解更多信息,请参阅 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(立即安装)"。

Install now CTA
Learn more CTA

行动号召按钮 (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>

所有结束页广告都应包含符合以下尺寸要求的 heightwidth 属性:

  • 正方形广告:最小宽/高均为 200 像素。
  • 横屏广告:最小宽/高为 480 x 320 像素。
  • 竖屏广告:最小宽/高为 320 x 480 像素。

结束页广告

视频播放完毕后,VAST 结束页广告以全屏结束页的形式出现。推荐的最佳实践是使用结束页广告来最大限度提高点击率。大多数发布者都允许跳到结束页,因此即使是可跳过的广告库存也会在用户退出广告体验之前显示结束页。

结束页广告点击支持

在展示结束页后,用户可以点击屏幕上的任意位置来触发事件 <CompanionClickTracking><CompanionClickThrough> 。结束页上不放置 Unity 行动号召按钮 (CTA)。

如需了解更多信息,请参阅 VAST 指南第 3.13 节

结束页资源类型

类型描述注意事项
<HTMLResource>
HTML 标记。
  • 标记中不应包含自定义的关闭按钮。
  • 支持 MRAID
  • 广告素材标记应在 HTML 或 Javascript 中包含点击函数,而不是在 <CompanionClickThrough> 元素中。
  • Android 设备认为 HTML 结束页的优先级高于其他资源类型。
<StaticResource>

要在 <img> 标签中展示的资源,例如 image/jpeg, image/jpg, image/gifimage/png

  • <CompanionClickThrough> 元素中提供点击 URL。
<IframeResource>

在 iframe 中被用作"src"的字符串。

支持的 VAST 4.x 宏

以下列表详细介绍了 Unity 支持的 VAST 4.x 宏(如果跟踪 URL 中提供了这些宏):

  • [ERRORCODE]
  • [OMIDPARTNER]
    • OM SDK 集成的标识符。
    • 这与 OMIDPartner 对象中的 nameversionString 参数相同。
  • [REASON]
    • 无法执行验证的原因代码。
  • [TIMESTAMP]
    • (时间戳)
  • [IFA]
  • [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 的 VASTAdTagURI

检查广告系列的状态为已开启。收到后的素材媒体文件最多会缓存两个小时。
视频文件太大至少提供一个小于 20 MB 的媒体文件。
平台或移动端浏览器无法播放媒体文件。

验证媒体文件和追踪 URL 是否是安全协议 HTTPS。在 URL 末尾包含文件扩展名,例如 .webm.mp4。尽管 URL 中不需要文件扩展名,但这样做可以减少在移动端浏览器中出现 MIME 类型的报错。

点击跳转链接

如果视频点击跳转 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

视频时长过长或格式不是 HH:MM:SS

300
封装错误。
301

一个 VastAdTagURI 超时。

302
超出封装层数上限(五个)。
303

解包后未找到 <Ad>

401
未找到支持的媒体文件。
402
媒体文件 URI 超时。
403
不支持的媒体文件。
404
媒体文件 URI 在 iOS 上不受支持。
499
无点击跳转 URL。
600
常规结束页广告错误。
601
不支持该结束页广告尺寸。
602
无法显示结束页广告。
603
无法获取结束页广告资源。
604
未找到有效的结束页广告资源链接。
699
结束页广告未包含有效的点击跳转链接。
900
未定义的错误。
998
VAST XML 内容包含无效的链接。
999
未知错误。