本文介绍了在 Vungle Exchange 上提供 VAST 广告的 DSP 合作伙伴的 Vungle 流程和规范。更多内容，请参阅IAB VAST 2.0文档。
支持
- Vungle Exchange 支持 VAST 2.0 和 3.0。
- Vungle Exchange 不支持 VPAID
- Vungle Exchange 不支持 MRAID 视频。有关更多信息，请参阅我们的MRAID 文档。
- VAST 内联和包装器
- XML 必须包含：
- 一个
.mp4媒体文件 - 比特率信息
- 媒体文件长度信息
- 媒体文件的高度和宽度
- 安全的资源
- 点击能进入落地页
- 任何重定向最多只能重定向一次
- 必须支持 SSL
- 支持的媒体MIME类型：
- 安卓：video/mp4
- iOS: video/mp4
- 不支持的媒体 MIME 类型：
- MOV, Flash, HLS
- 文件大小限制：
- 最长视频时长 120 秒
- 最小比特率为 250 kbps
- 响应时间：
- 对于流媒体：必须在 250 毫秒内
- 对于预先缓存的媒体：必须在 750 毫秒内
- VAST 扩展是可选的，但是如果加上会更好。
如果不满足上述任一需求，Vungle 将返回错误。
结束页（伴随广告）
我们鼓励所有 DSP 合作伙伴运行结束页以提高性能。支持 VAST 的广告资源支持随播广告或结束页。
实现
在 VAST 响应中，在<CompanionAds>元素内定义至少一个<Companion>节点，其中包含结束页面所需的资源文件信息。资源文件的类型可以是<StaticResource>或<HTMLResource> 。
StaticResource
以下是静态图像结束页的示例。
示例代码
<CompanionAds>
<Companion>
<StaticResource creativeType="image/jpeg">
< [CDATA[https://Your_endcard_image_url]]> // Required
</StaticResource>
<TrackingEvents>
<Tracking event='creativeView'>
< [CDATA[https://endcard_tracking]]> // Required
</Tracking>
</TrackingEvents>
<CompanionClickThrough>
< ![CDATA[https://endcard_click_through]]> // Required
</CompanionClickThrough>
<CompanionClickTracking>
< ![CDATA[https://endcard_click_tracking]]> // Required
</CompanionClickTracking>
</Companion>
</CompanionAds>HTMLResource
以下是 HTML 结束卡的示例。
示例代码
<CompanionAds>
<Companion>
<HTMLResource>
<![CDATA[
<div>Your end card content</div> // Content can not be empty
<script src=""></script>
]]>
</HTMLResource>
<TrackingEvents>
<Tracking event='creativeView'>
< ![CDATA[https://endcard_tracking]]> // Required
</Tracking>
</TrackingEvents>
</Companion>
</CompanionAds>
开放式测量
对于开放式测量支持，您必须在 VAST 代码中包含<Extension>和<AdVerifications>节点。此外，您必须在出价响应中传递API:7 。
<Extension type="AdVerifications">
<AdVerifications>
<Verification vendor="vendor name">
<JavaScriptResource apiFramework="omid" browserOptional="true">
<![CDATA[https://verification.com/omid_verification.js]]>
</JavaScriptResource>
<TrackingEvents>
<Tracking event="verificationNotExecuted">
<![CDATA[https://verification.com/omid_error?reason=[REASON]]]>
</Tracking>
</TrackingEvents>
<VerificationParameters>
<![CDATA[“Vendor name”]>
</VerificationParameters>
</Verification>
</AdVerifications>
</Extension>
VAST 请求示例
含有未填充参数的示例 VAST 请求 URL（VAST 标签）
https://partner.com/vast2/6524rgww153hifw/?duration=15&app_name={{{pub_app_name}}}&app_id={{{market_id}}}&rtb_type=instream_mobile_vast_inter&user_id={{{device_id}}}&ua={{{browser_user_agent}}}&random={{{timestamp}}}&ip_address={{{ip}}} 含有已填充参数的示例 VAST 请求 URL（VAST 标签）
https://partner.com/vast2/124765432/?duration=15&app_name=My%20Talking%20Tom%20Free%20for%20Android&app_id=com.outfit7.mytalkingtomfree&rtb_type=instream_mobile_vast_inter&user_id=6df43c89-9e3d-43fb-a1e9-bacd51932d41&ua=Mozilla%2F5.0%20(Linux%3B%20Android%204.4.2%3B%20SPH-L720%20Build%2FKOT49H)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Version%2F4.0%20Chrome%2F30.0.0.0%20Mobile%20Safari%2F537.36&random=2015-01-27T21%3A30%3A34%2B00%3A00&ip_address=66.87.114.254 VAST 请求参数
| 参数名称 | 宏 | 值 | 注释 | 示例 |
|---|---|---|---|---|
| 应用类别 | {{{pub_app_store_category}}} |
字符串 | 类别列表 | 游戏 |
| 应用名称 | {{{pub_app_name}}} |
字符串 | 来自 iTunes 或 Play 商店 | 家庭海滩农场 |
| 应用商店 URL | {{{pub_app_store_url}}} |
字符串 | 应用商店或内容 URL。已编码。 | https://play.google.com/store/apps/details?id=com.funplus.familyfarm&hl=en |
| 捆绑包 ID | {{{pub_market_app_id}}} |
字符串/整数 | 来自 iTunes 或 Play 商店 | com.funplus.familyfarm&hl=en (Android) 539920547 (iOS) |
| 城市 | {{{city}}} |
字符串 | 已编码 | 纽约 |
| 连接类型 | {{{connection_type}}} |
字符串 | Wifi、wwan、移动 | Wifi、wwan、移动 |
| 国家/地区 | {{{country}}} |
字符串 | 两个字母的国家/地区代码 | US |
| 设备 DNT | {{{ad_tracking_disabled}}} |
字符串 | 'True' 指示用户不允许广告跟踪 | True/False |
| 设备 DNT | {{{ad_tracking_enabled}}} |
字符串 | 'True' 指示用户允许广告跟踪 | True/False |
| 设备 DNT | {{{boolean_number ad_tracking_disabled}}} |
整数 | 不跟踪，二进制形式 | 0 – False 1 - True |
| 设备 ID | {{{device_id}}} |
字符串 | 原始或哈希的字串 | ab4d6cc4-f57f-4309-9d29-b7fb5e35dd74 |
| 设备型号 | {{{device_model}}} |
字符串 | 已编码 | Amazon,KFFOWI samsung,SM-J700T |
| IP | {{{ip}}} |
字符串 | 互联网协议地址 | 95.118.153.77 |
| 语言 | {{{language}}} |
字符串 | 语言中前两个字节的缩写 | 10.2.1 |
| 操作系统版本 | {{{os_version}}} |
字符串 | 操作系统版本（即 iOS 7.2） | 2014-12-05T00%3A44%3A19%2B00%3A00 |
| 平台 | {{{device_platform}}} |
字符串 | iOS 或 Android | iOS/Android |
| 屏幕高度 | {{{screen_height}}} |
整数 | 屏幕高度（像素） | 768 |
| 屏幕方向 | {{{screen_orientation}}} |
字符串 | 纵向或横向 | 纵向/横向 |
| 屏幕宽度 | {{{screen_width}}} |
整数 | 屏幕宽度（像素） | 1024 |
| 时间戳 | {{{timestamp}}} |
字符串/整数 | 已编码 | 2014-12-05T00:44:19+00:00 |
| 用户代理 | {{{browser_user_agent}}} |
字符串 | 来自头的 UA。已编码。 | Mozilla/5.0 (Linux; Android 5.1.1; VF-1397 Build/LMY47V; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/55.0.2883.91 Safari/537.36 |
| Vungle ID | {{{vungle_id}}} |
字符串 | 关心收益的 Vungle 发布者ID | 5497c989a3b61ba3660001b1 |