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

广告联盟成果报酬型网络广告平台成果网媒体实时接口实现手册爱德威广告（上海）有限公司版权所有2011年3月10日广告联盟成果报酬型网络广告平台目录一、说明...................................................................................................................................3二、关联...................................................................................................................................3三、实现步骤...........................................................................................................................3四、媒体接口实现...................................................................................................................3五、实现示例...........................................................................................................................5广告联盟成果报酬型网络广告平台一、说明本文档是提供给成果网媒体，针对想要实时接收在成果网发生的成果信息的媒体，指导开发数据接受接口的二、关联本文档是根据《成果网媒体实时接口说明V2.0》升级，接口方法向前兼容。三、实现步骤1、填写媒体接口地址和通配符2、按照成果网要求开发接口程序方法见第四节，媒体接口实现3、联系成果网工作人员测试和开通接口四、媒体接口实现方法：默认接受GET数据提交，如果媒体需要POST数据提交请联系成果网。媒体可选参数表：参数通配符说明参数格式成果网是否一定提供[DATE]发生日期Int，格式为YYYYMMDD是[TIME]发生时间Int，格式为HHMMSS是[TYPE]成果类型Int，1.CPA2.CPS是[PID]广告活动IDInt是[MID]广告活动名称String是[EXTINFO]下线信息,成果网广告链接里的e参数int型，可接受数字，最长9位，缺省为0如果有[USERINFO]用户信息,成果网广告链接里的u参数string型，可接受字母和数字，最长255位，缺省为‘’[COMM]媒体的总报酬浮点数，缺省为0是[TOTALPRICE]订单总价浮点数，缺省为0否，CPA成果无此信息[OCD]订单号String，缺省为‘’否，CPA成果无此信息[GOODSPRICECOUNT]商品分类/分成比例/分成/价格/数量，多个商品之间用冒号分隔例如：缺省为‘’GOODS2/10%/0.00/53.00/2:GOODS3/10%/0.00/26.00/2:GOODS1/10%/0.00/46.00/2CPA成果无此信息媒体提交到成果网的接口示例：=[DATE]&time=[TIME]&type=[TYPE]&pro广告联盟成果报酬型网络广告平台=[PID]&promotionName=[MID]&extinfo=[EXTINFO]&userinfo=[USERINFO]&comm=[COMM]&totalPrice=[TOTALPRICE]&OCD=[OCD]&goodDetails=[GOODSPRICECOUNT]＊数据签名：考虑到成果网和媒体数据的安全性问题，成果网会在提供实时成果数据的同时通过参数sig向媒体传递一个签名值，供媒体校验数据。签名方法：根据媒体提供的接口参数顺序，取参数部分（链接?以后），用实际数据替换通配符之后，将字符串和成果网提供的密钥用’&’拼接，再使用md5加密算法计算出signature的值。Signature=Md5(“date=[DATE]&time=[TIME]&type=[TYPE]&promotionID=[PID]&promotionName=[MID]&extinfo=[EXTINFO]&userinfo=[USERINFO]&comm=[COMM]&totalPrice=[TOTALPRICE]&OCD=[OCD]&goodDetails=[GOODSPRICECOUNT]”.“&key”)密钥请媒体直接联系成果网获取。返回值：返回值说明1媒体接收到订单信息，且信息正确-1接收到信息，但是解析信息中有不正确参数，需要核对-2signature校验不正确-3IP受限-4订单已存在为空或其他值成果网视媒体没有收到订单信息广告联盟成果报酬型网络广告平台五、实现示例媒体提交的接口地址为：=[DATE]&time=[TIME]&type=[TYPE]&promotionID=[PID]&promotionName=[MID]&extinfo=[EXTINFO]&userinfo=[USERINFO]&comm=[COMM]&totalPrice=[TOTALPRICE]&OCD=[OCD]&goodDetails=[GOODSPRICECOUNT]成果网准备提交的信息：参数名说明参数date发生日期20110307time发生时间032448type成果类型：1.CPA、2.CPS1pid广告活动ID1915mid广告活动名称“VANCL”extinfo下线信息,成果网广告链接里的e参数334455userinfo用户信息,成果网广告链接里的u参数Uid3212comm媒体的总报酬20.0000totalprice订单总价，CPA成果无此信息100.0000ocd订单号，CPA成果无此信息8845114535goodspricecount商品分类/分成比例/分成/价格/数量，CPA成果无此信息GOODS2/20%/0.00/20.00/2:GOODS2/20%/0.00/60.00/1成果网按照媒体提供的接口参数顺序拼接的字符串：date=20110307&time=032448&type=2&promotionID=1915&promotionName=%E5%A4%A9%E5%A4%A9%E7%9B%88CPA%E6%B4%BB%E5%8A%A8&extinfo=334455&userinfo=Uid3212&comm=20.0000&totalPrice=100.0000&OCD=8845114535&goodDetails=GOODS2/20%/0.00/20.00/2:GOODS2/20%/0.00/60.00/1成果网提供给媒体的密钥为(正式密钥请向成果网索取)：12345AB计算出的签名：Md5(‘date=20110307&time=032448&type=2&promotionID=1915&promotionName=%E5%A4%A9%E5%A4%A9%E7%9B%88CPA%E6%B4%BB%E5%8A%A8&extinfo=334455&userinfo=Uid3212&comm=20.0000&totalPrice=100.0000&OCD=8845114535&goodDetails=GOODS2/20%/0.00/20.00/2:GOODS2/20%/0.00/60.00/1&12345AB’)=‘bd1ef263350f3bfa340715170c2a8508’;成果网访问最终媒体的链接：=20110307&time=032448&type=1&pro广告联盟成果报酬型网络广告平台=1915&promotionName=%E5%A4%A9%E5%A4%A9%E7%9B%88CPA%E6%B4%BB%E5%8A%A8&extinfo=334455&userinfo=Uid3212&comm=20.0000&totalPrice=100.0000&OCD=8845114535&goodDetails=GOODS2/5%/0.00/20.00/2:GOODS2/20%/0.00/60.00/1&sig=bd1ef263350f3bfa340715170c2a8508