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

腾讯广告实时交易平台（TencentAdExchange）技术接入规范保密I腾讯广告实时交易平台技术接入规范广告平台产品部腾讯广告实时交易平台（TencentAdExchange）技术接入规范保密II目录1总体说明......................................................................................................................................11.1术语...................................................................................................................................11.2概述...................................................................................................................................12接入准备......................................................................................................................................32.1账号注册...........................................................................................................................32.2信息同步环节的API参数说明.......................................................................................32.2.1API系统参数（每个API都必须包含的参数信息）.........................................32.2.2API返回信息.........................................................................................................32.2.3API的参数编码.....................................................................................................62.2.4API的协议说明.....................................................................................................62.2.5参数校验错误时的ret_msg说明.......................................................................62.3账号信息设置...................................................................................................................62.4广告位信息同步...............................................................................................................72.5广告信息同步...................................................................................................................92.5.1上传广告信息........................................................................................................92.5.2获取审核未通过的广告信息..............................................................................102.5.3批量获取广告的审核状态..................................................................................112.6客户信息同步.................................................................................................................122.6.1批量上传客户信息..............................................................................................122.6.2批量获取客户的审核信息..................................................................................14腾讯广告实时交易平台（TencentAdExchange）技术接入规范保密III2.6.3获取审核通过客户的信息..................................................................................152.7CookieMapping..........................................................................................................163实时竞标....................................................................................................................................183.1BidRequest...................................................................................................................183.2BidResponse................................................................................................................233.3RTBAPIRequest/Responseprotobuf示例...........................................................253.4WinNotice....................................................................................................................253.5曝光监测和点击跳转.....................................................................................................25报表查看.........................................................................................................................................26附录.................................................................................................................................................28附录1行业编码和行业描述的数据字典..........................................................................28腾讯广告实时交易平台（TencentAdExchange）技术接入规范保密11总体说明1.1术语名称描述ADX腾讯广告实时交易平台（AdeXchange）DSP曝光购买方（Demandsideplatform）RTB实时竞标（RealTimeBidding）CMADX与DSP双方的用户ID映射技术（CookieMapping）TCMS腾讯CookieMapping服务TUID腾讯域的用户IDWinNoticeADX发送竞标成功DSP的获胜通知ROI投资回报率（ReturnonInvestment）1.2概述ADX是腾讯最新发布的广告实时交易平台，支持以实时竞标的方式售卖腾讯及其合作伙伴的广告曝光资源，为广告曝光交易提供了一种更加公平透明高效的方式。DSP代表广告主可以在ADX平台更加实时高效地购买腾讯及其合作伙伴的广告曝光，精准定位目标人群，从而进一步提高广告投放ROI；同时媒体合作伙伴也可以通过ADX将曝光以实时竞标的方式售卖出去，从而实现曝光流量地最大化变现。该文档面向DSP产品、开发人员，主要介绍DSP和ADX的接口技术规范，即DSP如何接入ADX并参与竞标。整个过程大致可以分为：接入准备、实时竞标和报表查看。接入准备DSP首先需要在ADX平台进行账号注册，然后进行广告位、广告信息的同步，并完成CookieMapping。通过账号注册，ADX会分配给DSP一个标识其合法身份的唯一ID，并需要DSP提供实时竞标服务器URL、CookieMapping服务器URL、默认WinNoticeURL等信息。同腾讯广告实时交易平台（TencentAdExchange）技术接入规范保密2时DSP可以根据广告位、行业分类等信息选择接入感兴趣的广告曝光和目标人群。广告位、广告信息的同步是指DSP从ADX同步媒体广告位信息，并将广告主及广告信息上传至ADX。相关信息通过审核后，才可以参与后续的实时竞标。审核过程包括对广告主资质，素材URL，点击跳转URL，曝光检测URL等信息的审核。CookieMapping是指ADX和DSP双方的用户ID映射。对于同一用户，在访问不同网站时会各自产生用来标识其身份的ID，存储在各自网站域下的Cookie中。因此将同一用户在不同网站域下的ID进行映射后，DSP才可以从ADX海量用户数据中识别出目标人群，并参与后续的实时竞标。实时竞标实时竞标(RTB)是指用户在访问媒体产生广告曝光机会时，众多家广告主（通常由DSP代理）根据曝光的上下文以及用户属性实时地评估曝光价值并给出报价，经过广告交易所拍卖后最终获胜的广告主赢得此次曝光机会。下图描述了一个曝光从发生到实时竞标，直到最后获胜广告展示的全过程：1)用户（user）向媒体网站（publisher）发起访问请求2)产生曝光机会时，媒体将用户重定向到ADX3)ADX向众多