跳到主要内容

PDB/PD 对接流程

一 商务沟通​

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 长连接

DSP 投放 PC 资源可选择进行 Cookie Mapping，也可以不选；移动端资源无需进行 Cookie Mapping。

具体操作参考 Cookie Mapping。

二 DSP 对接开发指引​

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

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

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

线上投放的相关提示：

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

三 新资源的对接​

1. 资源对接粒度​

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

2. 线上测试流量申请​

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

  • 收件人：junzhigao@tencent.com、andiali@tencent.com、v_zenanlin@tencent.com
  • 邮件标题：【申请 PDB 或 PD 线上测试】+ DSP 名称 + 测试资源（广告位 + 广告形式）
  • 邮件内容：
    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%