技术对接

贵公司的工程师在第二次沟通之前需要知道的一切

这个市场里的合作，最终由要负责落地实现的那个人拍板。这一页就是写给这个人的：版本、端点、我们不支持什么，以及我们对贵公司这一侧的要求。如果这里有哪一项与贵公司的技术栈不匹配，直接告诉我们，答复只有“行”或“不行”，而不是再开一场研讨会。

广告插播组（ad pod）· 90 秒广告时段 竞品隔离已开启 · 频次已设上限
SSAI
服务端拼接
OpenRTB 2.6
原生 ad pod 竞价
VAST 4.2
VMAP 时段规则
100%
本示例填充率

协议

OpenRTB
2.5 / 2.6 通过 2.6 的 imp.video.podid、podseq 和 slotinpod 实现 pod 竞价。为兼容旧系统，同时支持 2.5。
广告响应
VAST 4.2 / 4.1 / 3.0 使用 VMAP 1.0 做广告时段调度。不接受 VPAID，它不适合电视端。
广告插入
SSAI 与客户端 用贵公司的拼接器做服务端插入，或由播放器直接请求。
传输
HTTPS，POST 传 JSON 请求与响应均支持 gzip。TLS 最低版本 1.2。
超时
≤ 300 ms 这是我们这一侧的竞价超时；到时已经决出的结果就返回，而不是拖住广告时段。

供应侧

对接方式
S2S · SDK · 广告代码 CTV 默认使用服务端对服务端（S2S）。应用内库存用 SDK；实在没有别的办法时用 VAST 广告代码。
标识符
IFA / RIDA / 设备 ID 原样传递，并遵守 lmt 与 dnt。不做指纹识别，不生成合成标识符。
授权
app-ads.txt / ads.txt 我们以 DIRECT 条目出现在贵公司的库存授权文件中。只有贵公司要求时，才使用 RESELLER 记录。
数据报表
API + 每日导出 请求数、填充数、CPM，以及按应用、国家和设备划分的收入，与我们开票依据的数据完全相同。
结算
按合作伙伴商定 结算周期、方式与起付金额均在合同中约定，不由我们单方面规定。

质量与控制

无效流量
竞价前与竞价后 无法验证的流量不会被售出。被拒绝的部分会报给贵公司，不会悄悄丢掉。
品牌安全
行业类别与广告主屏蔽 贵公司的屏蔽名单在竞价之前生效，而不是在曝光之后。
竞品隔离
按 pod 生效 默认每个广告时段内同一广告主、同一行业类别各一条；可按合作伙伴单独配置。
频次控制
按设备、按投放计划 在我们这一侧强制执行，避免同一条广告在贵公司的视频流里反复出现。

我们需要贵公司提供什么

  • 01 一个可以让我们在正式上线之前竞价的测试流或测试端点。
  • 02 贵公司的广告时段结构：pod 有多长，每个 pod 里有几个广告位。
  • 03 一个可以把我们列进去的 app-ads.txt 或 ads.txt 文件。
  • 04 一位具名的技术对接人。对接卡住往往是因为缺人，而不是因为缺代码。
OpenRTB 请求示例、VAST 示例和一个测试端点。