成果网媒体实时接口实现手册

1、成果网媒体实时接口实现手册爱德威广告（上海）有限公司 版权所有2011年3月10日目录一、说明4二、关联4三、实现步骤4四、媒体接口实现4五、实现示例6一、 说明本文档是提供给成果网媒体，针对想要实时接收在成果网发生的成果信息的媒体，指导开发数据接受接口的二、 关联本文档是根据成果网媒体实时接口说明 V2.0升级，接口方法向前兼容。三、 实现步骤1、 填写媒体接口地址和通配符2、 按照成果网要求开发接口程序方法见第四节，媒体接口实现3、 联系成果网工作人员测试和开通接口四、 媒体接口实现方法：默认接受GET数据提交，如果媒体需要POST数据提交请联系成果网。媒体可选参数表：参数通配符说明参数格

2、式成果网是否一定提供DATE发生日期Int，格式为YYYYMMDD是TIME发生时间Int，格式为HHMMSS是TYPE成果类型Int，1.CPA 2.CPS是PID广告活动IDInt是MID广告活动名称String是EXTINFO下线信息, 成果网广告链接里的e参数int型，可接受数字，最长9位，缺省为0如果有USERINFO用户信息, 成果网广告链接里的u参数string型，可接受字母和数字，最长255位，缺省为COMM媒体的总报酬浮点数，缺省为0是TOTALPRICE订单总价 浮点数，缺省为0否，CPA成果无此信息OCD订单号String，缺省为否，CPA成果无此信息GOODSPRICE

3、COUNT商品分类/分成比例/分成/价格/数量，多个商品之间用冒号分隔 例如：缺省为GOODS2/10%/0.00/53.00/2: GOODS3/10%/0.00/26.00/2: GOODS1/10%/0.00/46.00/2CPA成果无此信息媒体提交到成果网的接口示例：/api/real_time_data.php?date=DATE&time=TIME&type=TYPE&promotionID=PID&promotionName=MID&extinfo=EXTINFO&userinfo=USERINFO&comm=COMM&totalPrice

4、=TOTALPRICE&OCD=OCD&goodDetails=GOODSPRICECOUNT数据签名：考虑到成果网和媒体数据的安全性问题，成果网会在提供实时成果数据的同时通过参数sig向媒体传递一个签名值，供媒体校验数据。签名方法：根据媒体提供的接口参数顺序，取参数部分（链接?以后），用实际数据替换通配符之后，将字符串和成果网提供的密钥用&拼接，再使用md5加密算法计算出signature的值。Signature= Md5(“date=DATE&time=TIME&type=TYPE&promotionID=PID&promotionName=MID&extinfo=EXTINFO&user

5、info=USERINFO&comm=COMM&totalPrice=TOTALPRICE&OCD=OCD&goodDetails=GOODSPRICECOUNT” . “&key”)密钥请媒体直接联系成果网获取。返回值：返回值说明1媒体接收到订单信息，且信息正确-1接收到信息，但是解析信息中有不正确参数，需要核对-2signature校验不正确-3IP受限-4订单已存在为空或其他值成果网视媒体没有收到订单信息五、 实现示例媒体提交的接口地址为：/api/real_time_data.php?date=DATE&time=TIME&type=TYPE&p

6、romotionID=PID&promotionName=MID&extinfo=EXTINFO&userinfo=USERINFO&comm=COMM&totalPrice=TOTALPRICE&OCD=OCD&goodDetails=GOODSPRICECOUNT成果网准备提交的信息：参数名说明参数date发生日期time发生时间type成果类型：1.CPA、2.CPS1pid广告活动ID1915mid广告活动名称“VANCL”extinfo下线信息, 成果网广告链接里的e参数userinfo用户信息, 成果网广告链接里的u参数Uid3212comm媒体的总报酬20.0000totalpr

7、ice订单总价，CPA成果无此信息100.0000ocd订单号，CPA成果无此信息goodspricecount商品分类/分成比例/分成/价格/数量，CPA成果无此信息GOODS2/20%/0.00/20.00/2: GOODS2/20%/0.00/60.00/1成果网按照媒体提供的接口参数顺序拼接的字符串：date=&time=&type=2&promotionID=1915&promotionName=%E5%A4%A9%E5%A4%A9%E7%9B%88CPA%E6%B4%BB%E5%8A%A8&extinfo=&userinfo=Uid3212&comm=20.0000&totalPr

8、ice=100.0000&OCD=&goodDetails=GOODS2/20%/0.00/20.00/2:GOODS2/20%/0.00/60.00/1成果网提供给媒体的密钥为(正式密钥请向成果网索取)：12345AB计算出的签名：Md5(date=&time=&type=2&promotionID=1915&promotionName=%E5%A4%A9%E5%A4%A9%E7%9B%88CPA%E6%B4%BB%E5%8A%A8&extinfo=&userinfo=Uid3212&comm=20.0000&totalPrice=100.0000&OCD=&goodDetails=GOODS2/20%/0.00/20.00/2:GOODS2/20%/0.00/60.00/1&12345AB)= bd1eff3bfac2a8508;成果网访问最终媒体的链接：/api/real_time_data.php?date=&time=&type=1&promotionID=1915&promotionName=%E5%A4%A9%E5%A4%A9%E7%9B%88CPA%E6%B4%BB%E5%8A%A8&extinf