视频广告#

视频广告投放模板（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 秒之间。
• 您可以最多包装 5 次 VAST 标签。
• 伴侣必须在初始视频广告结束后或跳过时全屏显示。
• 所有 HTML 标记都必须使用包含 https:// 和域名的绝对 URL 路径引用外部托管的资产。从 file:// 或相对 URL 路径指向资产不起作用。

包括针对不同环境的多个视频尺寸

• 最大视频文件大小为 20 MB。
• 在 WIFI 连接上，视频播放器将选择 5-10 MB 之间的文件。
• 在蜂窝网络连接上，视频播放器将选择 0.5-3 MB 之间的文件。
• 尽可能地包含纵向和横向模式的视频尺寸。

可跳过视频广告#

发布者控制用户是否可以在其应用程序中跳过视频广告。大多数可跳过广告要求用户观看固定时间（由发布者确定）才能跳过结束卡。由于大多数可跳过广告库存允许用户跳过结束卡，因此 Unity 强烈建议您在视频需求中包含一个结束卡。联系您的合作伙伴经理以详细了解可跳过和不可跳过广告库存。

视频控件#

Unity 的视频控件叠加层会在视频播放时淡入视图。用户可以通过点击屏幕来隐藏或再次显示它。叠加层包括屏幕底部的进度条、隐私图标和号召性用语（CTA）。它可能在右上角包含一个关闭按钮，或在左上角包含一个跳过图标。

视频点击支持#

VAST 标签必须在 <ClickThrough> 节点中包含单个视频点击跳转，并且可以在各自的 <ClickTracking> 节点中包含多个点击跟踪 URL。有关更多信息，请参阅 VAST 指南 的 **第 3.10 节**。

确保您遵循以下要求

• 点击跳转 URL 应在各自的平台上使用 https://、market://、itunes:// 或 itms:// 前缀。
• Unity 强烈建议使用服务器端重定向，而不是使用冗长的附加 URL。
• Unity 不支持使用 tel:// 前缀的点击拨打电话广告。
• 点击包装器可以包含额外的点击跟踪。

视频 CTA#

在视频播放期间，屏幕右下角会显示一个号召性用语（CTA）按钮。用户必须点击该按钮才能触发点击跳转事件并打开 <ClickThrough> URL。CTA 按钮默认显示为“了解更多”。如果创意的出价响应中存在捆绑 ID，则 CTA 按钮将显示为“立即安装”。

CTA 图标#

VAST 3.0 及更高版本支持使用图标。Unity 视频播放器在视频播放期间为包含捆绑 ID 的出价响应显示一个正方形图标，该图标位于“立即安装”按钮旁边。您可以在 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 节**。

结束卡资源类型#

支持的 VAST 4.x 宏#

以下列表详细介绍了 Unity 支持的 VAST 4.x 宏，如果它们在跟踪 URL 中提供

• [ERRORCODE]

  • 请参阅 错误代码。

• [OMIDPARTNER]

  • OM SDK 集成的标识符。
  • 这与 OMIDPartner 对象的 name 和 versionString 参数相同。

• [REASON]

  • 未执行验证的原因代码。

• [TIMESTAMP]

  • （时间戳）

• [IFA]

  • 来自设备特定广告 ID 方案（如 Apple 的广告商 ID 或 Android 的广告 ID）的可重置广告 ID，以 UUID 格式或基于 IAB 关于 OTT 平台广告标识符指南 的文档。

• [IFATYPE]

  • 一个字符串值，指示 [IFA] 宏中包含的 IFA 类型。

• [APIFRAMEWORKS]

  • 播放器支持的框架列表。
  • 值在 AdCOM 1.0 API 框架列表中定义。

• [APPBUNDLE(required)]

  • 对于应用程序广告，平台特定的应用程序标识符、捆绑包或包名称。此标识符不能是应用程序商店 ID，例如 Apple App Store ID。
    • 在需要且适用但未知或不可用时，设置为 -1 或 -2，如 IAB 关于 VAST 4.x 宏 的文档的 **第 6.1 节** 中所述。
    • 当需要且不适用（例如在应用程序中）时，设置为 0。

有关更多信息，请参阅 IAB 关于 VAST 4.x 宏 的文档。

故障排除#

展示次数少#

如果您遇到高赢率但特定视频广告系列或创意的展示次数很少，请考虑以下内容

点击跳转 URL#

如果视频点击跳转 URL 的查询字符串中包含正斜杠 (/) 或加号 (+)，则这些符号将使用其 UTF-8 等效项进行 URL 编码。这可能会干扰某些点击重定向并导致展示次数少。

例如

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] 宏替换为以下错误代码之一。这些错误发生在广告即将显示或已显示时。