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

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

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

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

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

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

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

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