使用条款

Mix-Mind系统公司（以下简称“Mix-Mind”）所有文档，接收者有保密义务。未经Mix-Mind书面许可，任何人或任何机构不得向第三方披露、泄露有关本文件的任何内容或细节。Mix-Mind拥有修改、调整、增补本文件的权利。Mix-Mind系统™和Mix-Mind Systems™及相关延展标识为Mix-Mind公司在中国和/或其他国家或地区的注册商标或商标。

AdExchange与DSP联调文档说明

版本历史

版本/状态	完成日期	备注
1.2.0.1	2020-10-12	Dsp联调文档初步建立

总述

为了方便DSP在接口开发完毕后快速接入AdExchange平台，Adexchange提供了与DSP联调文档，目的是让DSP了解联调的流程和需要为联调做的准备工作。Adexchange接口升级时，Dsp需要如何测试。另外本文档提供了对于数据差异GAP，DSP方应该做的一些排查工作。

对接说明

联调的目的是为了测试信息同步接口(参见DSP接口文档)和实时竞价接口(参见DSP接口文档)
联调步骤说明
1. 获取文档
2. 获取dspId和token
3. 开发接口
4. 测试非实时接口
5. DSP自测实时竞价接口
6. 沙箱联调测试
  - 测试实时竞价接口
  - 对数
  - 测试cookiemapping
7. 线上测试对数
8. 自助对接系统使用说明

获取文档

注：该信息通过邮件来沟通，不要通过qq，方便以后双方查询dspId和token数据。

DSP接口文档
DSP联调文档/本文档
价格加密解密包
为dsp在沙箱创建好dsp账号，随文档邮件发送

DSP开发接口

DSP需要根据DSP接口文档和DMP映射文档进行相应接口的开发工作

测试非实时接口

DSP在开发完毕后，请用邮件中获取的dspId和token测试信息同步接口,具体要测试的非实时接口详见DSP接口文档
沙箱环境提供的一个固定的，用来进行公共测试的dspId和token信息

"dspid":"11216",
"token":"f4f62e001f194f2faf387ac1a20bbe62"

接口	URL	METHOD	实例
广告位信息获取	http://sandbox.adx.xelements.cn/dsp/api/adplacements	POST	{“dspid”:“11216”,“token”:“f4f62e001f194f2faf387ac1a20bbe62”}
物料上传	http://sandbox.adx.xelements.cn/dsp/v2/api/upload	POST	{“dspid”:“11216”,“token”:“f4f62e001f194f2faf387ac1a20bbe62”,“creativeType”:“1”,“material”:[{“creativeId”:“material_1”,“category”:[],“url”:“http://d.yoyi.tv/plus/2016/05/30/4f4e1c62206f394e9d8ea4825360096e.swf”,“width”:400,“height”:300,“duration”:10,“advertiser”:“Mix-Mind”,“startdate”:“2015-05-07”,“enddate”:“2018-08-30”,“landingpage”:“http://tv.sohu.com/20150505/n412440832.shtml”,“action”:1,“monitor”:[}]}
物料审核结果	http://sandbox.adx.xelements.cn/dsp/v2/api/status	POST	{“dspid”:“11216”,“token”:“f4f62e001f194f2faf387ac1a20bbe62”,“creativeIds”:[“creative_1”,“creative_2”,“creative_3”]}
获取报表	http://sandbox.adx.xelements.cn/dsp/api/report	POST	{“dspid”:“11216”,“token”:“f4f62e001f194f2faf387ac1a20bbe62”,“type”:“general”,“startdate”:“2013-07-25”,“enddate”:“2013-07-29”}

DSP自测竞价接口

说明：dsp接口开发完毕后，先用curl命令自测实时竞价接口，dsp自测是为了能够保证DSP在收到模拟请求BidRequest(AdExchange发出的竞价请求)后，能够正确返回BidRespnse(即正确返回出价情况)，dsp自测没问题之后可以到AdExchange自助对接系统进行广告展示测试自助对接系统地址

联调测试

注：dsp到AdExchange自助对接系统进行测试,地址：自助对接系统访问地址

DSP自助配置bidurl
DSP测试信息同步接口注：dsp在联调测试前需要测试完毕信息同步接口详见上测试非实时接口
DSP上传测试素材
- 上传素材到沙箱环境素材上传接口地址
- 上传素材的尺寸请根据自助对接系统中提供的广告位尺寸进行选择
测试实时竞价接口
- 测试DSP曝光url和点击url是否成功发送，且服务器解析正确
沙箱对数
- 需要DSP手动刷AdExchange提供的测试页面，看一下双方的统计数据是否对得上。(如果之前数据有影响，请DSP将之前数据清空或对小时数据)
- 测试对的数据主要包括：
  1. 竞价请求数：AdExchange平台向dsp发送的请求数
  2. 竞价回应数：AdExchange平台收到的dsp返回的竞价响应数(该响应数包括DSP不出价情况和其他情况)
  3. 竞价成功次数：dsp在AdExchange平台上竞价成功次数
  4. 曝光量：AdExchange系统是按曝光来收费的,所以曝光量要重视
  5. 点击量
  6. 花费
- 沙箱对数没有问题，可以开始进行线上测试
注：沙箱对数的目的是为了看一下基本的数据统计有无问题，具体数据gap在线上投放进行测试

线上放量测试

线上信息互换，互换线上三个url(bidurl、cookiemapping url、winnotice url)和AdExchange平台(dspid、token)信息,以及AdExchange平台线上信息同步接口和cookiemapping接口
开启预存款、竞价和cookiemapping
1-2天的对数测试

自助对接系统使用说明

地址：自助对接系统访问地址

文档：

AdExchange竞价接口升级测试

注：在AdExchange竞价接口升级时，dsp可通过自助系统进行联调测试

Q&A

winnotice加密方式

采用AES加密，ECB加密模式　　base64编码

加密的Key是DSP账号的token。

为了和其他Exchange 统一，加密之前我们会在价格之后加上时间戳后缀，即形式如”PRICE_TIME”这样（例如：’201_1376468920380’），再进行加密。解密时请注意需要split出来分别获得价格和时间戳。这里的时间戳是精确到毫秒的。对于动态物料,可以在”bid”:”adm”字段中通过宏%%WINNING_PRICE%%来获取价格。

目录