腾讯广告实时交易平台技术接入规范详解.doc

腾讯广告实时交易平台（Tencent AdExchange）技术接入规范 保密 腾讯广告实时交易平台技术接入规范 广告平台产品部 I  腾讯广告实时交易平台（Tencent AdExchange）技术接入规范 保密 目 录 1 总体说明1 1.1 术语1 1.2 概述1 2 接入准备3 2.1 账号注册3 2.2 信息同步环节的 API 参数说明3 2.2.1 API 系统参数（每个 API 都必须包含的参数信息）3 2.2.2 API 返回信息 3 2.2.3 API 的参数编码 6 2.2.4 API 的协议说明 6 2.2.5 参数校验错误时的 ret_msg 说明6 2.3 账号信息设置6 2.4 广告位信息同步7 2.5 广告信息同步9 2.5.1 上传广告信息9 2.5.2 获取审核未通过的广告信息10 2.5.3 批量获取广告的审核状态 11 2.6 客户信息同步12 2.6.1 批量上传客户信息12 2.6.2 批量获取客户的审核信息14 II  腾讯广告实时交易平台（Tencent AdExchange）技术接入规范 保密 2.6.3 获取审核通过客户的信息15 2.7 Cookie Mapping 16 3 实时竞标18 3.1 Bid Request 18 3.2 Bid Response 23 3.3 RTB API Request/Response protobuf 示例 25 3.4 Win Notice 25 3.5 曝光监测和点击跳转25 报表查看26 附录28 附录 1 行业编码和行业描述的数据字典28 III  腾讯广告实时交易平台（Tencent AdExchange）技术接入规范 保密 1 总体说明 1.1 术语 名称 描述 ADX 腾讯广告实时交易平台（Ad eXchange） 曝光购买方（Demand side platform） 实时竞标（Real Time Bidding） DSP RTB CM ADX 与 DSP 双方的用户 ID 映射技术（Cookie Mapping） 腾讯 Cookie Mapping 服务 TCMS TUID Win Notice ROI 腾讯域的用户 ID ADX 发送竞标成功 DSP 的获胜通知 投资回报率（Return on Investment） 1.2 概述 ADX 是腾讯最新发布的广告实时交易平台，支持以实时竞标的方式售卖腾讯及其合作 伙伴的广告曝光资源，为广告曝光交易提供了一种更加公平透明高效的方式。DSP 代表广 告主可以在 ADX 平台更加实时高效地购买腾讯及其合作伙伴的广告曝光，精准定位目标人 群，从而进一步提高广告投放 ROI；同时媒体合作伙伴也可以通过 ADX 将曝光以实时竞标 的方式售卖出去，从而实现曝光流量地最大化变现。 该文档面向 DSP 产品、开发人员，主要介绍 DSP 和 ADX 的接口技术规范，即 DSP 如 何接入 ADX 并参与竞标。整个过程大致可以分为：接入准备、实时竞标和报表查看。 ? 接入准备 DSP 首先需要在 ADX 平台进行账号注册，然后进行广告位、广告信息的同步，并完成 Cookie Mapping。 通过账号注册，ADX 会分配给 DSP 一个标识其合法身份的唯一 ID，并需要 DSP 提供 实时竞标服务器 URL、Cookie Mapping 服务器 URL、默认 Win Notice URL 等信息。同 1  腾讯广告实时交易平台（Tencent AdExchange）技术接入规范 保密 时 DSP 可以根据广告位、行业分类等信息选择接入感兴趣的广告曝光和目标人群。 广告位、广告信息的同步是指 DSP 从 ADX 同步媒体广告位信息，并将广告主及广告信 息上传至 ADX。相关信息通过审核后，才可以参与后续的实时竞标。审核过程包括对广告 主资质，素材 URL，点击跳转 URL，曝光检测 URL 等信息的审核。 Cookie Mapping 是指 ADX 和 DSP 双方的用户 ID 映射。对于同一用户，在访问不同 网站时会各自产生用来标识其身份的 ID，存储在各自网站域下的 Cookie 中。因此将同一 用户在不同网站域下的 ID 进行映射后，DSP 才可以从 ADX 海量用户数据中识别出目标人 群，并参与后续的实时竞标。 ? 实时竞标 实时竞标 (RTB) 是指用户在访问媒体产生广告曝光机会时，众多家广告主（通常由 DSP 代理）根据曝光的上下文以及用户属性实时地评估曝光价值并给出报价，经过广告交易所拍 卖后最终获胜的广告主赢得此