成果網(wǎng)媒體實(shí)時(shí)接口實(shí)現(xiàn)手冊(cè)

1、成果網(wǎng)媒體實(shí)時(shí)接口實(shí)現(xiàn)手冊(cè)愛(ài)德威廣告（上海）有限公司 版權(quán)所有2011年3月10日目錄一、說(shuō)明4二、關(guān)聯(lián)4三、實(shí)現(xiàn)步驟4四、媒體接口實(shí)現(xiàn)4五、實(shí)現(xiàn)示例6一、 說(shuō)明本文檔是提供給成果網(wǎng)媒體，針對(duì)想要實(shí)時(shí)接收在成果網(wǎng)發(fā)生的成果信息的媒體，指導(dǎo)開(kāi)發(fā)數(shù)據(jù)接受接口的二、 關(guān)聯(lián)本文檔是根據(jù)成果網(wǎng)媒體實(shí)時(shí)接口說(shuō)明 V2.0升級(jí)，接口方法向前兼容。三、 實(shí)現(xiàn)步驟1、 填寫(xiě)媒體接口地址和通配符2、 按照成果網(wǎng)要求開(kāi)發(fā)接口程序方法見(jiàn)第四節(jié)，媒體接口實(shí)現(xiàn)3、 聯(lián)系成果網(wǎng)工作人員測(cè)試和開(kāi)通接口四、 媒體接口實(shí)現(xiàn)方法：默認(rèn)接受GET數(shù)據(jù)提交，如果媒體需要POST數(shù)據(jù)提交請(qǐng)聯(lián)系成果網(wǎng)。媒體可選參數(shù)表：參數(shù)通配符說(shuō)明參數(shù)格

2、式成果網(wǎng)是否一定提供DATE發(fā)生日期Int，格式為YYYYMMDD是TIME發(fā)生時(shí)間Int，格式為HHMMSS是TYPE成果類型Int，1.CPA 2.CPS是PID廣告活動(dòng)IDInt是MID廣告活動(dòng)名稱String是EXTINFO下線信息, 成果網(wǎng)廣告鏈接里的e參數(shù)int型，可接受數(shù)字，最長(zhǎng)9位，缺省為0如果有USERINFO用戶信息, 成果網(wǎng)廣告鏈接里的u參數(shù)string型，可接受字母和數(shù)字，最長(zhǎng)255位，缺省為COMM媒體的總報(bào)酬浮點(diǎn)數(shù)，缺省為0是TOTALPRICE訂單總價(jià) 浮點(diǎn)數(shù)，缺省為0否，CPA成果無(wú)此信息OCD訂單號(hào)String，缺省為否，CPA成果無(wú)此信息GOODSPRICE

3、COUNT商品分類/分成比例/分成/價(jià)格/數(shù)量，多個(gè)商品之間用冒號(hào)分隔 例如：缺省為GOODS2/10%/0.00/53.00/2: GOODS3/10%/0.00/26.00/2: GOODS1/10%/0.00/46.00/2CPA成果無(wú)此信息媒體提交到成果網(wǎng)的接口示例：/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數(shù)據(jù)簽名：考慮到成果網(wǎng)和媒體數(shù)據(jù)的安全性問(wèn)題，成果網(wǎng)會(huì)在提供實(shí)時(shí)成果數(shù)據(jù)的同時(shí)通過(guò)參數(shù)sig向媒體傳遞一個(gè)簽名值，供媒體校驗(yàn)數(shù)據(jù)。簽名方法：根據(jù)媒體提供的接口參數(shù)順序，取參數(shù)部分（鏈接?以后），用實(shí)際數(shù)據(jù)替換通配符之后，將字符串和成果網(wǎng)提供的密鑰用&拼接，再使用md5加密算法計(jì)算出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”)密鑰請(qǐng)媒體直接聯(lián)系成果網(wǎng)獲取。返回值：返回值說(shuō)明1媒體接收到訂單信息，且信息正確-1接收到信息，但是解析信息中有不正確參數(shù)，需要核對(duì)-2signature校驗(yàn)不正確-3IP受限-4訂單已存在為空或其他值成果網(wǎng)視媒體沒(méi)有收到訂單信息五、 實(shí)現(xiàn)示例媒體提交的接口地址為：/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成果網(wǎng)準(zhǔn)備提交的信息：參數(shù)名說(shuō)明參數(shù)date發(fā)生日期time發(fā)生時(shí)間type成果類型：1.CPA、2.CPS1pid廣告活動(dòng)ID1915mid廣告活動(dòng)名稱“VANCL”extinfo下線信息, 成果網(wǎng)廣告鏈接里的e參數(shù)userinfo用戶信息, 成果網(wǎng)廣告鏈接里的u參數(shù)Uid3212comm媒體的總報(bào)酬20.0000totalpr

7、ice訂單總價(jià)，CPA成果無(wú)此信息100.0000ocd訂單號(hào)，CPA成果無(wú)此信息goodspricecount商品分類/分成比例/分成/價(jià)格/數(shù)量，CPA成果無(wú)此信息GOODS2/20%/0.00/20.00/2: GOODS2/20%/0.00/60.00/1成果網(wǎng)按照媒體提供的接口參數(shù)順序拼接的字符串：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成果網(wǎng)提供給媒體的密鑰為(正式密鑰請(qǐng)向成果網(wǎng)索取)：12345AB計(jì)算出的簽名：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;成果網(wǎng)訪問(wèn)最終媒體的鏈接：/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