协议定义

一概述

Tencent Ad Exchange 与 DSP 之间采用基于标准 HTTP 的 Protocol Buffer 协议进行实时交互，请注意以下几点：

根据 DSP 在 adx.qq.com 管理平台上提供的 bid_url，Tencent Ad Exchange 会事先建立起 TCP 长连接，请尽量保持长连接。不稳定的连接会导致发送失败；如果 DSP 会主动断开该连接，请提前告知腾讯。
Tencent Ad Exchange 采用 HTTP/1.1 协议，使用 POST 方法发送请求。DSP 无论是否参与竞价，均需要回复 HTTP/1.1 200 OK，可以加上 Connection: keep-alive，不可使用 Connection: close。
请 DSP 支持接收 POST pipeline 请求模式：Tencent Ad Exchange 会持续发送多个实时请求，DSP 处理完成后逐个回复。此模式并非标准 HTTP 协议所支持，请重点关注，介绍详见 https://en.m.wikipedia.org/wiki/HTTP_pipelining。
基于 HTTP，Tencent Ad Exchange 使用 Google Protocol Buffer 2，字段定义详见后续 proto 文件。
DSP 回复时，无论是否参与竞价，均需要返回请求ID（Response.id 或 Direct_Response.id）；如果参与竞价，则需要返回对应的曝光ID（Response.seatbid.Bid.impid 或 Direct_Response.seatbid.Bid.impid）；如果回退，直接对相应的曝光ID不回复，无需带曝光ID。

腾讯 PDB/PD 协议的新、老两个版本已经合并，请使用最新协议。协议根据素材是否需要审核，分为审核接口和免审接口。

普通 DSP 只能使用审核接口，特殊需求需向产品经理申请。
审核接口与免审接口的 Request 部分完全共用，仅 Response 部分使用的字段存在差异。
合约订单（PDB/PD 订单）可以用 deal_id 匹配流量，不建议 DSP 使用协议中广告位或素材规格等字段匹配流量。
PDB 订单的移动端、TV 端流量，媒体保证实际外发的协议中至少包含一个设备ID，建议 DSP 按顺序取用（设备ID包含 idfa、openudid、imei、oaid、androidid、qaid、mac 等，详见协议文档）。
ADX 可提供模拟测试工具（仅包含协议中的基础字段），DSP 如有需要可向产品经理申请。