Vungle VAST 2.0 集成指南

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

  1. 合作伙伴向 Vungle 发送技术文档(如果有)。

  2. 合作伙伴向 Vungle 发送 VAST 测试端点。
    注意:在测试阶段,合作伙伴必须 100% 响应 Vungle 的出价请求,以生成重要的测试结果。

  3. Vungle 构建测试环境以根据需要调用合作伙伴的端点。
    这用于验证变量值和跟踪信号。

阶段 2

  1. 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

     

    还有其它问题?提交请求

    评论