本文介绍帮助新 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 |