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

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

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

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

7、ice訂單總價，CPA成果無此信息100.0000ocd訂單號，CPA成果無此信息goodspricecount商品分類/分成比例/分成/價格/數(shù)量，CPA成果無此信息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)提供給媒體的密鑰為(正式密鑰請向成果網(wǎng)索取)：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;成果網(wǎng)訪問最終媒體的鏈接：/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