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

1、腾讯广告实时交易平台(Tencent AdExchange)技术接入规范保密腾讯广告实时交易平台技术接入规范广告平台产品部目录1总体说明11.1术语11.2概述12接入准备32.1账号注册32.2信息同珮节的API参数说明32.2.1 API系统参数(每个API都必须包含的参数信息)32.2.2 API返回信息32.2.3 API的参数编码62.2.4 API的协议说明62.2.5参数校验错误时的ret_msg说明62.3 62.4广告位信息同步72.5广告信息同步92.5.1上传广告信息92.5.2获取审核未通过的广告信息102.5.3批量获取广告的审核状态112.6客户信息同步12261批

2、传客户信息122.6.2批量获取客户的审核信息14n腾讯广告实时交易平台(Tencent AdExchange)技术接入规范保密263获取审核通过客户的信息152.7 Cookie Mapping163实时竞标183.1 Bid Request183.2 Bid Response233.3 RTB API Request/Response protobuf 示例253.4 Win Notice253.5曝光监测和点击跳转25报表查看26附录28附录1行业编码和行业描述的数据字典281H腾讯广告实时交易平台(Tencent AdExchange)技术接入规范保密1总体说明1.1术语名称描还ADX

3、腾讯广告实时乂易平台(Ad exchange )DSPBS光购买方(Demand side platform )RTB实时見标(Real Time Bidding )CMADX与DSP双方的用户ID映射技术(Cookie Mapping )TCMS腾讯 Cookie Mapping 服务TU1D腾讯域的用户IDWin NoticeADX发送兗标成功DSP的获胜通知ROI投资回报率(Return on Investment)L2概述ADX是腾讯最新发布的广告实时交易平台，支持以实时竞标的方式售卖腾讯及其合作 伙伴的广告曝光资源，为广告曝光交易提供了一种更加公平透明高效的方式。DSP代表广 告主可

4、以在ADX平台更加实时高效地购买腾讯及其合作伙伴的广告曝光,精准定位目标人 群,从而进一步提高广告投放ROI;同时媒体合作伙伴也可以通过ADX将曝光以实时竞标 的方式售卖岀去，从而实现曝光流量地最大化变现.该文档面向DSP产品、开发人员，主要介绍DSP和ADX的接口技术规范，即DSP如 何接入ADX并参与竞标。整个过程大致可以分为：接入准备、实时竞标报表查看.接入准备DSP首先需要在ADX平台进行账号注册，然后进行广告位、广告信息的同步，并完成 Cookie Mappingo通过账号注册，ADX会分配给DSP 个标识其合法身份的唯一ID ,并需要DSP提供 实时竞标服务器URL、Cookie

5、Mapping服务器URL、默认Win Notice URL等信息。同 时DSP可以根据广告位、行业分类等信息选择接入感兴趣的广告曝光和目标人群。广告位、广告信息的同步是指DSP从ADX同步媒体广告位信息，并将广告主及广告信 息上传至ADX。相关信息通过审核后，才可以参与后续的实时竞标。审核过程包括对广告 主资质，素材URL，点击跳转URL ,曝光检测URL等信息的审核。Cookie Mapping是指ADX和DSP双方的用户ID映射。对于同一用户，在访问不同 网站时会各自产生用来标识其身份的ID ,存储在各自网站域下的Cookie中。因此将同一 用户在不同网站域下的ID进行映射后，DSP才可

6、以从ADX海量用户数据中识别出目标人 群,并参与后续的实时竞标。实时竞标实时竞标(RTB)是指用户在访问媒体产生广告曝光机会时众多家广告主(通常由DSP 代理)根据曝光的上下文以及用户属性实时地评估曝光价值并给出报价，经过广告交易所拍 卖后最终获胜的广告主赢得此次曝光机会.下图描述了一个曝光从发生到实时竞标,直到最后获胜广告展示的全过程:1) 用户(user)向媒体网站(publisher)发起访问请求2) 产生曝光机会时，媒体将用户重定向到ADX3) ADX向众多家DSP并行发起曝光竞标请求4) DSP进行估值后给出此次曝光的报价，ADX集齐DSP报价返回后进行拍卖ADX对竞标成功的DSP发

7、送获胜通知3腾讯广告实时交易平台(Tencent AdExchange)技术接入规范保密5) ADX按照媒体广告模板进行样式渲染后，将获胜DSP的广告返回给用户展示其中ADX与DSP的实时交互集中在3),4),5),具体API详见第三章节。报表查看当DSP接入ADX后，可以通过DSP自助平台查看每天广告的竞标、曝光、点击和消 耗等明细数据.同时ADX也提供相应API供DSP定期获取报表数据，详见第4章节。2接入准备2.1账号注册在DSP和ADX双方运营人员初步沟通会议之后，由ADX运营人员以邮件方式提供DSP账号和相应的Token信息。(暂不提供线上提交注册信息功能)2.2信息同步环节的API

8、参数说明描述了 DSP平台的系统参数(每个API都必须包含的参数信息丄返回信息及相应参数 的编码要求。另外每个API都可能会有业务参数，具体的业务参数参见具体的API。2.2.1 API系统参数(每个API都必须包含的参数信息)蓼数名称绘否必须含义dsp_id是DSP在ADX系统中的ID ,用来标识使用API的是哪个DSPtoken是DSP对应的token值，用来进行权限验证2.2.2 API返回信息API以JSON格式返回，返回信息是由如下的参数组成的对象对应的JSON数据:參数名称是否必须含义ret.code是0 :执行濒1 :全部执行失败2 :部分执行成功，部分执行失败3:系统认证失败或

9、吉系统内部错冕retmsg*如杲API执行成功，逅回结栗数娼或成功提示值息;如杲执行失 败,返回具体的错误提示信息error.code如杲API执行失败，来标识具休的错谋代码.请参考100-199的系统谱误定义error code详细定义：100-199系统错误error.code错误注釋100系统措误，谴稍后冉试101谱误的DSP ID或token;DSP IDJoken验证失败102业务处理的过程中发生错误，可能是参数错误，或考是传入的信息不合法之类 的，溝具体参考每个API的ret.msg说明ret.msg中出现的错误码的详细定义：300-399参数错误errorcode错谍注释300必

10、须的参数没有传入301至少必须传入此组参数中的一个302参数必须为整数303参数恪式错误304参数不在允许的值的范圈内305勢数不是正数306参数不是合法的URL307参数太长，超出了允许的长度范围308参数不是合法的YYW-MM-DD的日期309不是合法的JSON数据，无法被解析310可以被解析但是是空的JSON数据311参数太短，小于允许的氏度范围312可以被解析的JSON数据，但不是API要求的JSON格式313参数不是0或正数314参数的值太大，超过了允许的最大值315參数的值不允许被修改400-499各个API通用错误error.code猶误注釋400客户ID不存在/没有匹配的客户信

11、息500-599客户相关API业务逻辑错误error.code错误注释500客户名称重复503容户不能被修改504客户行业不合法505容户URL为空或者是URL不合法506容户vocation为空或舌是vocation不合法507客户area为空508容户 qualification_class 不合法509内部错误，更新DB的过程中发生了错渓510客户 qualificationjiles 不合法511容户filename不合法512客户file.url不合法513不支持的容户资质文件的格式，目前支持的文件格式：jpg,jpeg,gif,png514内部措误，文件移动失败，可能理文件过大51

12、5客户name为空516客户memo为空600-699广告素材相关API业务逻辑错误error.code错谍注释601文件加载失败602未知的文件格式，文件的恪式无法识别603不支持的文件格式目前支持的文件格式：jpg,gif,png,swf,flv604Flv秦材获取不到时长倍息605URL对应的素材发生了变化，请换一个URL606执行插入过程中发生了错谋，请关注是吞是同时上传607文件过大609秦材URL为空或育是地址不合法610目标地址为空或音是地址不合法611客户名称为空612第三方曝光监测地址错谋613素材过大，超过素材的大小限制614传入的filejnfo格式错谋615URL对应的

13、容户发生变化,不能上传616同一次谴求中，一个素材URL出现了多次800-899报表数据相关API业务逻辑错误error.code错误注释801传入的结束时间大于开始时间802超过开始和结束时间限制，目前只支持一次查询少于7天的数据，如杲时间段过氏，请仍査询2.2.3 API的参数编码参数的编码请使用UTF-82.2.4 API的协议说明所有的参数传递，请通过POST提交。2.2.5参数校验错误时的ret_msg说明API在校验参数时,发生错误,ret.msg的信息是 诸误编码二参数名的数组，Demo如下：306":"mapping_urr/bid_urr2.3账号信息设置

14、DSP 可以通过 API 设置 RTB url r Cookie Mapping url f default win notice url #QPS ,是否接受通投，是否接受腾讯用户属性,RTB消息格式等信息。相应的 API 接口 ： ；coiifig/set请求的业务参数信息:宇段名称类型描还mapping.urlstringCookie Mapping URLbid.urlstringRTB URLwin.notice.urlstringdefault win notice urlqpsintQPS , 0为不限制，目前ADX允许最高QPS 为:LOWn o_cmesponsestring

15、是否接受通投，丫或N，丫为接受,N为不接 受use.tuseri nfostring是否接受腾讯用户雇性，Y或N , Y为接受， N为不接受rtbmsgjormatstringRTB消息恪式，json或pb返回的参数信息:宇段名称类型ret.codeint返回的编码，详情谴蓼考API参数ret.msgstring ORarray of objects成功时，成功的提示信息； 失败时(参数校验错误)，详情淸 参考参数校验错误返回说明error.codeint歸码2.4广告位信息同步从ADX下载广告位信息，包含广告位ID、广告尺寸、支持的播放类型、资源底价、禁 止投放的行业等，可通过API接口访问

16、或者下载Excel查看相应的 API 接口 ： 请求信息中可以包含业务参数，业务参数及详细含义如下：字段名称类型描还datestring上次更新的时间戡：将返回该时间之后修改过的广告位信息可以为空，为空时返回当前支持的广吿位列表(该参数2012-05-18号开始支持)恪式要求：YYYYMMDD返回的参数信息:宇段名称类型描述ret.codeint返回的编码,详情谓参考API参数说明ret.msgarray of objects广吿位的相关信息error.codeint错误码正常返回时r ret_msg的示例："total" :2r"count* 2"re

17、cords* :locationjd* : *Astro_F_Rectangle,r , " :1星座频道-内容页矩形大图.,style" : "300*250' fcpm_start-price" : 20,blocl<_voc8tiorr :,"allow_filew : rjpgTgifyswfTpngqscreen" ：review_pic,F :" ,locationJd" : "LV.lOOl.LDVLLD" f|ocation_namew :

18、 腾讯视频-常规-点播-前贴片.,style" : "400*300",cpm_start_price,f : 15 fblock_vocation* : 010"020"/allow_file:"flv*f"enable" : "N"screen" : "Y","review pic":"另，追加对ret.msg.records中每一属性的解释说明：广告位ID: |ocation_id,r : 'Astro_F_Rectang

19、lew ,广吿位名称：-location_nameM :星座坝週-内容页-矩形大图.，广吿位的尺寸：-style":300*250，广告位的CPM起拍价，单位元(¥) : 'cpm_start_pricew : 20 ,广吿位上限制的行业:'block_x ocatioii* :,广吿位上支持的素材(物料)的文件格式：allow_file" ： "jpg-Zgif.-swr/png-广吿位的屏次：screen" : U未设置，Y首屏，N非首屏，T discuz弹窗 如杲广告位从支持变成不支持时，"enable"

20、;为N ,开不总会出现2.5广告信息同步广告信息需要事先审核，只有审核通过的广告才可能通过ADX播放岀来，可通过API接口上传广告信患、或者通过管理系统人工上传。另通过接口 ,获取审核未通过的广告信息。2.5.1上传广告信息相应的 API 接口 ： 请求信息中需要包含业务参数，业务参数及详细含义如下：宇段名称类型描述file_infostring本次同步震要新壇/修改的广吿信息，是JSON格式的数掲请求信息filenfo的示例：file.urr : "targeting_url“ : "",client_nameM : 广吿主的中文名称，跟通过管理系统录入的广吿主

21、名称一致9"monitor.urr : J."file.urr :11 "targeting_url“ : '* fclient_namew : 广告主的中文名称，跟通过管理系统录入的广告主名称一致"monitor.urr : rhttp:13腾讯广告实时文易平台(Tencent AdExchange)技术接入规范保密返回信息说明:字段名称类型描还ret.codeint返回的编码，详情请参考API参数说明ret.msgarray of objects如杲是参数校验错谋，返回的详细信 息谴参考参数校验错误返回说明 如果是处理过程中出现错误，返回的信

22、 息是错谋的Code类型跟文件URL 的数组，如Demo所示.error.codeint错误码有错误发生时,ret.msg中前面的数值是错误的code类型,后面的数组是该错误类型下的文件URL列表，示例如下:"400" :H t "601":H 2.5.2获取审核未通过的广告信息相应的 API 接口 ： 请求信息中可以包含业务参数，业务参数及详细含义如下:字段名称类型描述upload-datestring上传的时间：将返回该时间之后上传的所有 未审核通过的广吿列表可以为空,为空时返回所有的审核未通过的 广告列表恪式要求：YYYY-MM-DD返回信息说明：

23、宇段名称类型描述ret.codeint返回的编码,详情请参考API参数说明腾讯广告实时交易平台(Tencent AdExchange)技术接入规范保密ret.msgarray of objects亩核未通过的素材列表error_codeint谱误码正常返回时，reLmsg的信息是未审核通过的素材列表,示例如下:total" 2count" :2,records* :"file.urr : " ."targeting.url* :BB."reason" : 默认素材不需要上传了."file.url* : "

24、 , "targeting_urT : "11 r "reason* : 素材跟削柠专链接地址不符2.5.3批量获取广告的审核状态相应的 API 接口 ： 根据素材URL列表获取素材的审核状态.请求信息中需要包含业务参数，业务参数及详细含义如下：字段名称类型描述file.urlnfostring打算获取审核状态的素材URL的列表，是JSON恪式的数堀请求信息file_ul_info的示例:"返回信息说明：宇段名称类型描述ret.codeint返回的编码，详情请蔘考API参数说明11髓讯广告实时交易平台(Tencent AdExchange)技术接入规范保

25、密ret.msgarray of objects素材的地址及跳转地址对应的审核状 态和厦因(审核不通过时,有原因，M 他的没有)error.codeint错误码正常返回时,reLmsg的信息是未审核通过的素材列表,示例如下："total: 2.-count*: 2t "records": "http：V/442.swf:（Bhttp：V/-: status:1审核通过.）, "http：V/15922.gif": "http：V/l23H: status": 审核不趣： reason':嚼常地址惜涙,不可访

26、问,*http：V/: status: 待审核2.6客户信息同步客户信息需要事先进行资质审核，只有审核通过的客户的广告才可以参与竞标，并最终 被播放展示。目前可通过API接口上传客户信息或者通过管理系统人工上传。此外，也可 以通过相应API接口，获取客户的审核状态信息。2.6.1批量上传客户信息相应的 API 接口 ： 批量上传客户的信息，包括名称、url，以及客户的资质文件等。请求信息中需要包含业务参数，业务参数及详细含义如下：字段名称类型描述clientjnfostring本次同步零要新壇/修改的客户信息.是JSON恪式的数娼JSON中具体的参数信息:宇段名称类型描述namestring客

27、户名称，必须参数，如杲该客户不存在，则新堵；如杲已存在则修改信息newamestring新客户名称,可选参数，仅用于修改已有的 客户的名称urlstring客户的url .新增时是必须參数，修改时是可选參数overwrite ualificationbool是否覆盖资质文件，可选参数，默认是false , 即每次的资质文件都量墳墨的.不会删除原 来的文件；如果是true ,则会用新传入的资 质文件覆盖掉原来的资质文件qualificatio n_filesarray资质文件信息，可选参数，JSON恪式的数组.为文件的描述名称,file.url为可获取到该文件的urlmemos

28、tring备注信息，必须参数请求信息clientjnfo的示例:name" : "clieriLnamel","urP : Bhttp：V/*.qualificationjiles* ::"企业营业执照 */file.url":"http:/file_name":"ICP 证"file_uiT：http:/adsfileqqcom/2gif,memo: 备注fs®".name" : client_name2B fBurr : Bhttp：V/new

29、":"新容户名称："overwrite.qualificatio rT:true,躅讯广告实时交务平台(Tencent AdExchange)技术接入规范保密qualification-files":"*:* 法人代表身份证/file_urr：*http：V/ rfile_name:TCPi正“节血_51:http:/adsfileqqcom/4jpg.memo': 备注信息返回信息说明:字民名称描述reLcodeint返回的编码，详情谴参考API参数说明retmsgarray of ob

30、jects如果是夢数枝验谱误，返回的详细信 息请蔘考参数校验错误返回说明 如果是处理过程中出现错误，返回的信 息忌错谋的Code类型跟客户名称 的数组,如Demo所示.error, codeint错谍码有错误发生时，ret.msg中前面的数值是错误的code类型,后面的数组是该错误类型下的客户名称列表,示例如下："503-:HclienLnamelw , "513B:rclient_name2“ 2.6.2批量获取客户的审核信息相应的 API 接口 ： 根据客户名称列表获取客户的审核信息。请求信息中需要包含业务参数，业务参数及详细含义如下:宇段名称类型描还namesarra

31、y客户名称的列表,是JSON恪式的数鋸请求信息names的示例:"dien t namel*/client name2w返回信息说明：宇段名称类型描述ret.codeint返回的编码，详情谴參考API参数说明ret_msgarray of objects客户的审核状态和审核意见error.codeint错误码正常返回时,ret.msg的信息是客户的审核信息列表,示例如下："l: "verify.status":"待审核： auditjnfo-：-客户新建，等待审核", is.black:Y：."clie

32、nt_name2": "verify.status:"不通过： auditjnfo'：-资质文件不符合要求", is_blacm2.6.3获取审核通过客户的信息相应的 API 接口 ： 通过该接口可以获取客户的详细信息。返回信息说明:宇段名称类型描还ret.codeint返回的编码，详情请蔘考API参数说明ret.msgarray of objects容户的详细借息error.codeint错误码正常返回时,reLmsg的信息是客户的审核信息列表,示例如下："total: 2."count": 2t"rec

33、ords": -name:"u5faeu8f6fHurr：*http：V/zh-cn/default.aspx"fis.black:”verify_status:T."addjime:-2012-11-08 11:41:57memo":Bu5faeu8f6ftypefADX-,clientJd'-r-Sg-,Rname-:"PICC Ju54clu724c "url*http:A/www.e-is.black:"verify.status:T.add.time:"2012-11-08 11:41:

34、57"memo":Bu5faeu8f6f"type":' u54clu724c "2.7 Cookie MappingCookie Mapping是为了建立ADX和DSP用户ID的映射关系，为DSP参与后续的 实时竞标做准备. 映射关系存储为了方便以后可能的多种合作方式，ADX和DSP双方都存有该映射，目前Cookie Mapping的发起方为DSP。 tuid的生命周期tuid是根据腾讯用户id ,dspid等诸多因素重新哈希生成的ADX用户id，用来和DSP 的用户id逬行mapping.目前其有效期目前为1个月，DSP需要周期性发

35、起Cookie Mapping。Cookie Mapping 流程17腾讯广告实时文易平台(Tencent AdExchange)技术接入规范保密1) 用户到达DSP网络时，通过内嵌网站上的pixel，访问DSP的Cookie Mapping 服务器。2) DSP判断该用户是否与ADX在一定时间内做过Cookie Mapping.如果没有， DSP的Cookie Mapping服务器则将该请求重定向到TCMS ,并在重定向的请求 参数中加上dspid、dspuid和gettuid, DSP也可以加上自己自定义的扩展参数 ext,即请求被重定向为http:/cm 丄 q 二 xxx&ge

36、ttuid 二 l&ext=xxxTCMS收到该请求后将保存该用户的dspuid，并将该请求再次重定向到DSP 的Cookie Mapping服务器，同时在请求参数中加入该用户的tuid ,如果在请求 中DSP带上了 ext扩晨参数，也会被加入到菱数中，同时参数中会添加上版本号 ver信息,即请求被重定向为： 二 yyyy&ver二 1&ext=xxx,如果请求参数错误，返回如下错误码<?xml version="1.0" encoding="utf-8"?>< respond > vcode > 错

37、误码 </code><desc>错误描述 v/desc></respond >错误円错误描述躅讯广告实时交务平台(Tencent AdExchange)技术接入规范保密-2DSP 1D不存在或告错谍-3DSPUID不存在或音措误如果获取不到tid ,则返回的重定向为注意:其中传入的参数dspuid可用字符为字母和数字，下划线"； +” :“。3 ) DSP收到此请求后,将保存该用户的tuid ,并给浏览器返回响应包，至此Cookie Mapping完成，ADX和DSP双方都获得该用户的dspuid和tuido4 ) DSP的自定义参数。如果D

38、SP不希望接受到的参数为tuid ,则可以使用如下方法进行 定制：DSP在每次请求中使用如下URL :http:/cm 丄 q 二 xxx&dspuid 二 xxx&tpadm 二 Ip则此时请求会被重定向为： 1&ext二xxx3实时竞标3.1 Bid RequestADX 的 RTB API 参考通用的 OpenRTB 规范,http:/code.google.eom/p/operutb/. 协议采用HTTP POST，开启keep-alive，消息格式为JSON或者ProtoBuf,目前timeout 设为 100ms。请求中需要设 Content-Type 为

39、application/json 或者对应 ProtoBuf 的 application/x-protobuf f 并增设-tencentrtb-version 为 0.1。Bid Request结构如下图所示:#腾讯广告实时文易平台(Tencent AdExchange)技术接入规范保密Bid Request ObjectImprion ObjectBanner ObjectORVideo ObjectSite ObjectDevice ObjectUsr Object Request object详细字段及含义：宇段名称类型描述idstring请求IDimparray of objects

40、曝光对象次request可以包含多个impsiteobject媒体站点对象deviceobject设备对象userobject用户对象atinteger竞标方式，1为明拍，2为暗拍(second pricing ) imp object只包含一个banner或video对象,不会同时包含：宇段名称类型描述idstring曝光IDtagidstring广告位IDbidfloorfloat底价，单位是分/千次曝光，即CPMbannerobjectbanner类型的广吿位videoobjectvideo类单的广告位 banner object详细字段及含义：宇段名称类型描述Winteger广吿位宽度

41、碍讯广告实时交另平台(Tencent AdExchange)技术接入规范保密hinteger广告位高度 video object详细字段及含义：宇段名称类型描述mimesarray of string支持播放的广告格式,video/x-ms-wmv, video/x-flvlinearityinteger广吿展现样式,1为in-stream, 2为overlaymindurationinteger视频广告最短播放时氏maxdurationinteger视频广告最长播放时长protocolinteger视频广吿的權放协议,目前暂为空winteger广吉位菟度hinteger广吿位高度 site

42、object详细字段及含义：宇段名称类型描还namestring媒体网站名称pagestring当前央面URLrefstringreferrer URL device object详细字段及含义：宇段名称类型描述uastringuser agentpstringIP user object详细字段及含义：宇段名称类型描还idstringADX用户IDbuyeridstring映射的DSP用户IDgenderstring性别，M代茨男F代表女不填代表未知ageinteger年龄(0-20 (0 X 21-30 ( 1 X 31-40 ( 2 41-50(3)、51-60(4)、60+(5)这几个

43、分段)不填代表未知 Bid Request - banner JSON 格式示例"at": 1,"device": ip": °Bua": "mozilla, firefox",id": "requestidl23imp :"banner" : h:250rw:300.-bidfloor": 0.1000000014901161,"id": "impidl230-tagid-: -portaLOl&quo

44、t;,"banner*: h:250f-w-:300.HbidfloorR : 0.1000000014901161,"id": Bimpidl231"tagid-: -portaL02".site-: "name": "tencet portal",page": B"ref" : ""."user": buyerid*: "buyeridl23*f "id": °tuidl23" Bi

45、d Request 一 video JSON 格式示例"at": 1,"device": ip": T92.1680"uaw: "mozilla, firefox"h"id": Brequestidl23"impw:bidfloor-: 0.1000000014901161,"id-: -impidl23tagid": wportaL01video11: h:250,"linearity": 1,"maxduration":

46、15r"mimes": wmimes0 "mimesl "mimes2B f"minduration": 5."protocol": 3.:300I"site": "name-: "tencet portal"page": ",Bref": "0L"user": "buyerid": "buyeridl23id- : -tuidl23"3.2 Bid Response

47、DSP正常出价响应包的返回状态码为HTTP 200 ok ,决定不出价的则为204 no contento 其他情况会当做出错处理 # 如 403 forbidden 或 500 internal server erroroBid Response结构如下图所示:Bid Response ObjectSeat Bid ObjectBid Object Bid Response object详细字段及含义：宇段名称类型描述idstring请求IDbididstring对应的 bidder response idseatbidarray of objectsDSP出价 seatbid object

48、详细字段及含义:宇段名称类型描还bidarray of objects针对单次曝光的出价bid object详细字段及含义：宇段名称类型描述idstringbidder response idimpidstring对应的曝光IDpricefloatDSP出价，車位是分/千次曝光，即CPMnurlstringwin notice urladmstring广告素材URLextstringdsp自定义字段 Bid Response JSON 格式示例1"bidid": "bidid_request_responsel23id": "requestid

49、l23"seatbid*:"bid":adid": Badidl230"adm*:Bhttp:/adserver.eom/a.jpg"id": bididjmpression_responseidl230°impid*: "impidl23*rnurl":nurll23：price" : 0.2000000029802322,"adm*: http:/adserver.eom/a.jpg"rBidR: bididjmpression.responseidll231*

50、impidB: "impidl23*f25躅讯广告实时交务平台(Tencent AdExchange)技术接入规范保密nurlM : Bnurll23price" : 0.20000000298023223.3 RTB API Request/Response protobuf 示例RTB. proto3.4 Win NoticeADX对竞标成功的DSP发送获胜通知(win notice url )，协议为HTTP GETOADX支持DSP可以通过宏替换来定义每次竞标的win notice url (即Bid response 中的nurl字段1如果nurl为空，则ADX会发送DSP在账号注册时提供的默认win notice url。目前支持的宏如下：参数宏描述impid$AUCT1ONJMPJDImpression IDbidimpid$AUCTION.BIDJD)Bid Impression ID from dsp responseprice$AUCTION_PRICESettlement p