新浪广告交易平台api接入规范.docx

新浪广告交易平台Sina Ad eXchange（SAX）API接入规范修订历史版本说明修改人员确认人员2012-09-251.0初始版本蒋子俊，周为2012-10-301.0.1修订展示竞价响应消息中的监控url以及RTB竞价金额单位蒋子俊2012-11-61.0.3修改HTML snippet中可以使用的宏的说明王曦2012-11-121.0.4增加价格加密机制的说明王曦2013-03-211.0.5合并管理端消息修订张志波2013-04-121.0.6创意上传审核接口增加上传创意代码片段张志波2013-4-231.0.7增加3种尺寸的广告位类型王曦2013-05-071.0.8增加广告主资质及创意资质审核，修改广告主、创意提交接口张志波2013-07-041.0.9增加340*120的广告位类型王曦2013-07-161.1.0增加9种广告位尺寸王曦2013-9-181.1.1增加资源位置尺寸查询乔振鹏2013-9-181.1.2营业执照查询乔振鹏2013-10-161.1.3增加资源位置查询乔振鹏2013-10-161.1.4DSP删除接口乔振鹏2013-10-161.1.5广告主删除接口 乔振鹏2013-12-31.1.6增加广告位张锴目录1系统概述41.1术语41.2概述52管理平台52.1接入准备52.1.1账户邀请52.1.2账户设置62.1.3广告主审核广告主提交广告主审核状态查询62.1.4物料审核物料上传物料审核状态查询92.1.5广告位同步102.2报表查看103交易平台103.1竞价协议103.1.1版本信息103.1.2状态转移103.1.3超时时间113.1.4数据格式113.1.5用户隐私113.1.6安全性113.1.7金额单位113.2竞价API竞价请求消息广告位消息(ad_unit)竞价请求消息示例143.2.2竞价响应消息竞价响应消息广告位/创意消息(ad_creative)创意列表消息(creative)竞价响应消息示例173.2.3竞价确认消息竞价确认消息竞价获胜通知(ad_price)竞价确认消息示例193.3数据交换203.3.1Cookie Matching新浪-DSPDSP -新浪214附录说明214.1创意类型214.2物料格式214.3广告位类型214.4广告位置224.5行业编码224.6价格加密23系统概述术语术语描述备注SAX新浪广告交易平台(Sina Ad eXchange)本规范中SAX和Sina Private Exchange同义DSP需求方平台(Demand Side Platform)便于广告客户和代理公司购买媒体的广告库存SSP供应方平台(Supply Side Platform)便于媒体管理和优化广告库存资源DMP数据管理平台(Data Management Platform)对第一方、第三方数据整合、标准化和细分的统一技术平台RTB在线竞价(Real Time Bidding)对每一次广告展示曝光进行竞价Cookie MatchingCookie匹配/映射为解决cookie跨域问题，需要对SAX侧和DSP侧的cookie进行映射。本规范中Cookie Matching和Cookie Mapping同义sid用户sina cookie经过加密后的唯一标识竞价过程中，不会直接使用用户的sina cookieWin NoticeSAX对获得竞价的DSP发送赢得竞价通知收到赢得竞价通知后，DSP可记录相应广告曝光日志QPS每秒处理请求数(Query Per Second)对DSP侧进行流量压力保护ROI投资回报率(Return on Investment)概述过去的几年中，欧美的展示广告市场发生了较大的变化：(1) 由过去忽视数据能力向重视数据进化，(2) 由Media Buy向Audience Buy进化， (3) 由若干分散的Network市场向Exchange开放市场进化。由此催生了一系列的Exchange请求信息中需要包含业务参数，业务参数及详细含义如下（修改为每次只上传一个广告主信息）：字段名称类型描述dspId是DSP在ADX系统中的ID，用来标识使用API的是哪个DSPtoken 是DSP对应的token值，用来进行权限验证advertiserIdstring广告主id，字符串类型nameString广告主名称industryString广告主行业qualificationFilesFile[ ]广告主企业资质文件列表（1个或多个），必填。如果有多个文件而少上传了，可能会导致审核拒绝，请注意广告主上传返回信息成功例子：{ data: { }, status: 0, statusInfo: {global:上传成功}}失