协议定义

1 概述

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

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

2 协议说明

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

  • 普通DSP只能使用审核接口，特殊需求需向产品经理申请。
  • 审核接口与免审接口，协议的Request部分完全共用，仅Response部分使用的字段存在差异
  • 合约订单（pdb/pd订单），使用deal ID匹配流量可以，不建议dsp使用协议中广告位或素材规格等字段匹配流量

  • pdb订单的移动、TV端流量，媒体保证实际外发协议中至少包含一个设备id，建议dsp按顺序取用（设备id包含idfa、openudid、imei、oaid、androidid、qaid、mac等，详见协议文档）

  • ADX可提供模拟测试工具（仅包含协议中的基础字段），DSP如有需要可向产品经理申请

proto文件下载地址：

【企微文档】腾讯AMS-ADX协议—PDBPD（免审非免审共用）
https://doc.weixin.qq.com/doc/w3_AEsA-gZ1ACctghrspvaRhCbvCaSIr?scode=AJEAIQdfAAoeNpOpGkABEAewY2ACk

协议字段使用说明：

    • 字段说明中包含（仅rtb）：表示RTB业务使用，PDB/PD可以忽略该字段（RTB业务已暂停使用该协议）
    • 字段说明中包含（仅pd&pdb）：表示PDB/PD业务使用，RTB可以忽略
    • PDB/PD业务重点看deal_id和device字段，以及urser字段。