PDB/PD对接流程 – Tencent AdExchange

一商务沟通

1 开通服务商账号

通过腾讯商务侧，在腾讯广告平台现开通“服务商账号”，并提供服务商账号的UID，用于创建DSP账号

2 提供账号信息

1. DSP简称
2. 隐私标识
3. 登陆QQ号（可以提供多个）
4. 公司网址
5. 邮箱（重要！用于查收下单，及ADX更新的通知邮件，可填多个）
6. 联系人
7. 联系电话
8. 告警邮箱：实时投放错误率达到告警值时邮件相关技术人员（可填多个，以英文分号分隔）

3 生成帐号

腾讯接口人为DSP开通账号，开通后，DSP可通过提供的QQ号登录adx后台。
账号开通后，腾讯将为DSP提供线上真实流量测试，主要测试实时响应、流量控制、曝光展示等。测试通过代表DSP符合腾讯AdX投放要求，可进行正式投放。

4 帐号设置

DSP接口人登陆ADX系统设置bid_url等信息。
（1）设置方式：ADX系统-平台设置-DSP配置-腾讯AdX数据配置
（2）bid_url：DSP实时竞价服务器的完整地址，AdX会主动向这个URL发起TCP长连接

5 Cookie Mapping（可选）

DSP投放PC资源可选择进行Cookie Mapping，也可不选。移动端资源无需进行Cookie Mapping。
具体操作参考：开始开发-Cookie Mapping

http://wiki.adx.qq.com/%E5%BC%80%E5%A7%8B%E5%BC%80%E5%8F%91/cookiemapping/

二 DSP对接开发指引

DSP侧的开发工作主要分为两部分，分别是：

实时协议：实时协议接口（PDB/PD适用）
广告创意提交接口：基础API接口（PDB/PD适用）

DSP开发完成后，即可按照下述“新资源对接”流程，申请线上测试流量。

线上投放的相关提示：

目前PDB/PD订单已不必DSP侧提交广告主，而是在下单后，ADX会将广告主自动同步到DSP账号下；创意提交使用的广告主必须与下单的广告主一致（从下单通知邮件中查看）
ADX支持的资源库：https://docs.qq.com/sheet/DSnFHTHFvTFZ0VkNP
DSP对接完成以后，请定期查看wiki中的“最新通知”页面，获取ADX侧更新信息（更新的通知邮件只发送给近期有订单投放的DSP账号）。如DSP长时间未投放订单，复投之前，务必仔细查看ADX的更新通知，并查看“实时协议”的变化，做好适配。
正式投放前，请登录ADX平台，通过扫描二维码，接收线上订单的错误码告警信息（平台设置-DSP设置页面）

三新资源的对接

1 资源对接粒度

DSP与ADX之间，需要按照“广告形式”粒度逐个对接，每个资源都需要经过线上测试

2 线上测试流量申请

DSP侧准备好以后（实时协议对接完成，可线上投放），发邮件申请测试流量，如下：（一般申请PDB测试即可，PDB测试通过后，PD订单也可使用）

（1）收件人：junzhigao@tencent.com;yabohe@tencent.com;jackkywang@tencent.com;v_zenanlin@tencent.com;

（2）邮件标题：【申请PDB或PD线上测试】+DSP名称+测试资源（广告位+广告形式）

（3）邮件内容：

1.真实投放计划（客户、预算、投放时间）

2.测试资源（广告位+广告形式）+测试日期

3 腾讯系统下单

腾讯接口人根据邮件申请内容，在腾讯内部系统新建排期进行下单。
（1）排期包含如下信息：客户、时间、广告位、广告形式、定向条件、预定量、推送倍数、deal_id
（2）线上测试，用腾讯的内部客户下单。DSP只需通过客户接口同步，无需新建客户

4 同步deal_id

DSP接口人有3种方式查收订单详情与同步deal_id。
（1）排期同步API接口
（2）接口人邮件：平台设置-DSP配置-腾讯AdX信息同步-广告投放邮箱
（3）AdX系统界面：数据报表-投放明细管理

5 上传素材

DSP通过广告素材API上传素材。
（1）DSP同步到客户名称后，按照广告形式的素材规格与顺序要求，通过广告素材API，将测试素材上传至该客户名下
（2）无需新建客户，只需通过接口同步
（3）线上测试素材由腾讯接口人给到，用腾讯内部素材
（4）上传素材必须指定广告形式id（display_id）

6 同步素材审核状态

腾讯接口人审核素材，DSP通过广告素材API同步状态。

7 系统配置

DSP系统配置deal_id与广告素材，开启投放策略。

8 更新配置状态

DSP开启投放策略后，在AdX系统更新配置状态，腾讯AdX根据此状态进行放量。由于配置失误造成的客户缺量损失，由DSP承担。
操作界面：数据报表-投放明细管理，操作设置为“配置完成”

9 腾讯接口人放量

腾讯接口人根据配置状态，进行放量。

10 实时竞价

DSP接收到腾讯AdX的流量请求后，在100ms内，按照实时竞价协议进行正确答复。只有通过接口同步到状态为通过的素材才可以用于答复。
（1）PDB：DSP必须在N倍推送的约定下，按比例进行正确的接受与回退流量
（2）PD：DSP可任意进行接受与回退流量，但回退率过高，腾讯ADX会减少流量请求
（3）项目与技术负责人必须及时处理放量过程中的告警信息

11 评估结果

放量结束后DSP与腾讯对比数据，双方评估本次线上测试是否达标。流量数据可通过ADX系统界面：数据报表-整体流量、运营分析页面查看。
（1）接受率/回退率与理想接受率/回退率GAP<5%
（2）超时率<2%
（3）DSP异常流量=0
（4）曝光GAP<5%

一 商务沟通