Vungle VAST 2.0 集成指南

Vincent Yao

2020年03月05日 09:15

本文介绍帮助新 VAST 合作伙伴将其技术集成到我们程序化广告平台的 Vungle 流程和规范。

VAST 响应规范

出价响应必须遵守以下规范：

最大视频时长为 30 秒
最小比特率为 250 千位节/秒
XML 必须包含：

一个 .mp4 媒体文件
比特率信息
视频长度信息

任何重定向最多只能重定向一次
响应时间：

对于流：必须在 250 毫秒内
对于预先缓存：必须在 750 毫秒内

必须点击进入登录页面
必须支持 SSL 并使用安全资产响应
在无广告时使用‘no-ad’或‘403’响应
VAST 扩展是可选的，但是首选的

如果上述要求有任何一个未达到，Vungle 将返回错误。

Vungle 合作伙伴集成协议

Vungle 将帮助新 VAST 合作伙伴将其技术集成到程序化广告平台的流程分为两个阶段。第一个阶段可以形容为常规验证：Vungle 检测标签，确保正确触发服务器调用并正确填充值。第二个阶段涉及严格的测试，在这个阶段，我们在一组有统计意义的展示中搜索差异，以确保 Vungle 的数字与合作伙伴一致。's numbers align with the partner'

阶段 1

合作伙伴向 Vungle 发送技术文档（如果有）。
合作伙伴向 Vungle 发送 VAST 测试端点。
注意：在测试阶段，合作伙伴必须 100% 响应 Vungle 的出价请求，以生成重要的测试结果。
Vungle 构建测试环境以根据需要调用合作伙伴的端点。
这用于验证变量值和跟踪信号。

阶段 2

Vungle 与合作伙伴合作设置测试活动。

合作伙伴发送模拟实时需求的测试端点。
Vungle 设置运行预先确定的数量的展示的测试活动。
合作伙伴与 Vungle 协调交付、比较差异。
如果出现任何跟踪、确定目标或不一致问题，Vungle 将与合作伙伴一道进行调试，直到解决所有问题。

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

Vungle VAST 2.0 集成指南

目录

VAST 响应规范

Vungle 合作伙伴集成协议

VAST 请求示例

VAST 请求参数

Questions?