多麥cps廣告聯(lián)盟廣告主方對接文檔

1、 杭州多麥電子商務(wù)有限公司多麥cps廣告聯(lián)盟廣告主方對接文檔商家在多麥cps聯(lián)盟的帳號：商家在多麥cps聯(lián)盟的密碼：商家推送訂單的hash值：請?zhí)峁┤缦聝蓚€接口地址1.接入你們廣告的接口地址2.查詢你們訂單的接口地址另外希望支持3.訂單推送功能1. cps 接入地址（舉例說明）國美電器（此鏈接有四個部分： 1. 為gome的cps接入地址。2.sid=106 這個是gome 分配給聯(lián)盟的身份標識，用來判斷cps 點擊的來源3.feedback=10026_236_0_dGVzdA%3D%3D 這個是聯(lián)盟下面投放廣告活動鏈接的網(wǎng)站主的標識（這個值需要電商記錄并且在訂單推送和查詢的時候提供給聯(lián)盟，

2、此值一般在200字符以內(nèi) 希望電商能記錄 200位字符 如果有問題雙方協(xié)商解決）。4.to=http%3A%2F%2F%2F 這個是gome 提供給聯(lián)盟的自定義鏈接地址 用戶點擊后最終顯示的就是這個頁面。備注說明:希望你方能提供類似功能的接口地址給聯(lián)盟技術(shù)人員特別注意：1.在用戶點擊多個聯(lián)盟cps 鏈接到商家網(wǎng)站的情況下， 訂單應(yīng)該歸屬最終點擊的那個聯(lián)盟。（記得同時覆蓋/清除掉其他聯(lián)盟的cookie ）2.Cookie 的有效期 請按照雙方商務(wù)合作上面約定 的 RD 期為準。2. cps 訂單查詢地址（舉例說明）我們希望獲取如下信息含義詳細描述多麥傳遞過去的網(wǎng)站主標識必選這個就是接入地址里面的

3、 feedback 參數(shù)記錄的值訂單編號必選下單時間必選訂單金額必選用戶實際支付的金額 去掉使用優(yōu)惠券/現(xiàn)金券/快遞費 等不計算傭金的那部分金額優(yōu)惠金額可選訂單使用優(yōu)惠券/現(xiàn)金券 等其他非實付金額的部分優(yōu)惠券號可選訂單狀態(tài)可選如果你們接口給出的數(shù)據(jù)是 0 1 2 3 這樣的數(shù)字 請給出對應(yīng)的狀態(tài)描述傭金比例可選傭金金額可選如果可以的情況下 我們也希望能夠獲取訂單詳細的商品信息商品編號可選商品名稱可選商品數(shù)量可選商品單價可選商品傭金比例可選商品分類編號特殊特殊參數(shù)請參考附錄2 舉例商品分類名稱特殊如果你方的傭金計算是按照商品分類來的，那么請傳遞此值 同時告知我方技術(shù)人員 此值和你方商品分類的對應(yīng)

4、關(guān)系備注說明：關(guān)于計算傭金的部分：如果你方的傭金提成方式是按照商品分類來的，那么為了準確的預(yù)估訂單/商品的傭金，聯(lián)盟還需你方提供相關(guān)能夠判斷傭金的參數(shù) 比如商品分類編號/商品傭金比例 這些。關(guān)于接口參數(shù)： 我們一般希望查詢某一時間段的數(shù)據(jù) 所以可能的參數(shù)為 查詢的起始時間 和 結(jié)束時間聯(lián)盟訪問訂單查詢接口頻率： 聯(lián)盟方會每隔 2分鐘訪問一次電商提供的訂單查詢接口 以獲取最新的訂單數(shù)據(jù)表現(xiàn)形式：可以為 xml 文檔 也可以為 json 串 ，直接輸出 文本格式的數(shù)據(jù)也可以（一行一個商品或者訂單信息 屬性之間采用tab 鍵分隔）3. 訂單推送用戶下單后，希望你方能夠及時將訂單相關(guān)信息推送給聯(lián)盟具體

5、推送方式可以協(xié)商。如果是直接往聯(lián)盟現(xiàn)有接口推送數(shù)據(jù)的話： 請將訂單數(shù)據(jù)推送到此地址： （GET/POST皆可）此地址接受參數(shù)識別表含義對應(yīng)標識(區(qū)分大小寫)詳細描述電商身份標識hash必選推送訂單的hash值聯(lián)盟傳遞給電商的網(wǎng)站主標識euid必選這個就是接入地址里面的 feedback 參數(shù)記錄的值此值格式請參考第四部分的說明此值最長在200個字符左右，希望你方預(yù)留足夠長度的字段存儲此值。訂單編號order_sn必選下單時間order_time可選未傳遞采用當前時間 時間格式為 Y-m-d H:i:s 2012-04-04 03:23:09訂單金額orders_price必選用戶實際支付的金額

6、 去掉使用優(yōu)惠券/現(xiàn)金券/快遞費 等不計算傭金的那部分金額優(yōu)惠金額discount_amount可選訂單使用優(yōu)惠券/現(xiàn)金券 等其他非實付金額的部分優(yōu)惠券號promotion_code可選訂單狀態(tài)status可選如果你們接口給出的數(shù)據(jù)是 0 1 2 3 這樣的數(shù)字 請給出對應(yīng)的狀態(tài)描述訂單/商品傭金比例rate可選訂單/商品傭金金額commission可選商品編號goods_id可選商品名稱goods_name可選商品單價goods_price可選商品數(shù)量goods_ta可選默認為 1商品分類編號goods_cate可選商品分類名稱goods_cate_name可選字符編碼encoding可選如

7、果此次推送的數(shù)據(jù)包含中文且非UTF8編碼 請設(shè)置相應(yīng)的編碼值如：推送的為gbk 數(shù)據(jù) encoding=gbk如果數(shù)據(jù)默認為 UTF8 編碼則無需設(shè)置此值測試模式test可選當傳遞test 參數(shù)后 請求后會反饋相關(guān)的推送提示。您可以訪問：或者：查看備注說明：推送的數(shù)據(jù)需要和讀取接口數(shù)據(jù)保持一致如果推送商品信息 相關(guān)的商品各個屬性之間采用 | 鏈接4. 多麥聯(lián)盟的網(wǎng)站主標識格式說明多麥聯(lián)盟傳遞給商家的網(wǎng)站主標識由4部分組成，每部分之間通過下劃線拼接比如有如下網(wǎng)站主標識10026_287_0_dGVzdA= 10026 為站長在多麥的用戶ID 287 為商家在多麥的活動ID 0 為商家在多麥的活動素材ID dGVzdA= 為站長填寫的反饋數(shù)據(jù)（經(jīng)過base64編碼）10026001_287_0_dGVzdA= 10026002_287_0_dGVzdA= 10026 為站長在多麥的用戶ID 001/002 為站長的網(wǎng)站編號287 為商家在多麥的活動ID 0 為商家在多麥的