多麦cps广告联盟广告主方对接文档

1、 杭州多麦电子商务有限公司多麦cps广告联盟广告主方对接文档商家在多麦cps联盟的帐号：商家在多麦cps联盟的密码：商家推送订单的hash值：请提供如下两个接口地址1.接入你们广告的接口地址2.查询你们订单的接口地址另外希望支持3.订单推送功能1. cps 接入地址（举例说明）国美电器（此链接有四个部分： 1. 为gome的cps接入地址。2.sid=106 这个是gome 分配给联盟的身份标识，用来判断cps 点击的来源3.feedback=10026_236_0_dGVzdA%3D%3D 这个是联盟下面投放广告活动链接的网站主的标识（这个值需要电商记录并且在订单推送和查询的时候提供给联盟，

2、此值一般在200字符以内 希望电商能记录 200位字符 如果有问题双方协商解决）。4.to=http%3A%2F%2F%2F 这个是gome 提供给联盟的自定义链接地址 用户点击后最终显示的就是这个页面。备注说明:希望你方能提供类似功能的接口地址给联盟技术人员特别注意：1.在用户点击多个联盟cps 链接到商家网站的情况下， 订单应该归属最终点击的那个联盟。（记得同时覆盖/清除掉其他联盟的cookie ）2.Cookie 的有效期 请按照双方商务合作上面约定 的 RD 期为准。2. cps 订单查询地址（举例说明）我们希望获取如下信息含义详细描述多麦传递过去的网站主标识必选这个就是接入地址里面的

3、 feedback 参数记录的值订单编号必选下单时间必选订单金额必选用户实际支付的金额 去掉使用优惠券/现金券/快递费 等不计算佣金的那部分金额优惠金额可选订单使用优惠券/现金券 等其他非实付金额的部分优惠券号可选订单状态可选如果你们接口给出的数据是 0 1 2 3 这样的数字 请给出对应的状态描述佣金比例可选佣金金额可选如果可以的情况下 我们也希望能够获取订单详细的商品信息商品编号可选商品名称可选商品数量可选商品单价可选商品佣金比例可选商品分类编号特殊特殊参数请参考附录2 举例商品分类名称特殊如果你方的佣金计算是按照商品分类来的，那么请传递此值 同时告知我方技术人员 此值和你方商品分类的对应

4、关系备注说明：关于计算佣金的部分：如果你方的佣金提成方式是按照商品分类来的，那么为了准确的预估订单/商品的佣金，联盟还需你方提供相关能够判断佣金的参数 比如商品分类编号/商品佣金比例 这些。关于接口参数： 我们一般希望查询某一时间段的数据 所以可能的参数为 查询的起始时间 和 结束时间联盟访问订单查询接口频率： 联盟方会每隔 2分钟访问一次电商提供的订单查询接口 以获取最新的订单数据表现形式：可以为 xml 文档 也可以为 json 串 ，直接输出 文本格式的数据也可以（一行一个商品或者订单信息 属性之间采用tab 键分隔）3. 订单推送用户下单后，希望你方能够及时将订单相关信息推送给联盟具体

5、推送方式可以协商。如果是直接往联盟现有接口推送数据的话： 请将订单数据推送到此地址： （GET/POST皆可）此地址接受参数识别表含义对应标识(区分大小写)详细描述电商身份标识hash必选推送订单的hash值联盟传递给电商的网站主标识euid必选这个就是接入地址里面的 feedback 参数记录的值此值格式请参考第四部分的说明此值最长在200个字符左右，希望你方预留足够长度的字段存储此值。订单编号order_sn必选下单时间order_time可选未传递采用当前时间 时间格式为 Y-m-d H:i:s 2012-04-04 03:23:09订单金额orders_price必选用户实际支付的金额

6、 去掉使用优惠券/现金券/快递费 等不计算佣金的那部分金额优惠金额discount_amount可选订单使用优惠券/现金券 等其他非实付金额的部分优惠券号promotion_code可选订单状态status可选如果你们接口给出的数据是 0 1 2 3 这样的数字 请给出对应的状态描述订单/商品佣金比例rate可选订单/商品佣金金额commission可选商品编号goods_id可选商品名称goods_name可选商品单价goods_price可选商品数量goods_ta可选默认为 1商品分类编号goods_cate可选商品分类名称goods_cate_name可选字符编码encoding可选如

7、果此次推送的数据包含中文且非UTF8编码 请设置相应的编码值如：推送的为gbk 数据 encoding=gbk如果数据默认为 UTF8 编码则无需设置此值测试模式test可选当传递test 参数后 请求后会反馈相关的推送提示。您可以访问：或者：查看备注说明：推送的数据需要和读取接口数据保持一致如果推送商品信息 相关的商品各个属性之间采用 | 链接4. 多麦联盟的网站主标识格式说明多麦联盟传递给商家的网站主标识由4部分组成，每部分之间通过下划线拼接比如有如下网站主标识10026_287_0_dGVzdA= 10026 为站长在多麦的用户ID 287 为商家在多麦的活动ID 0 为商家在多麦的活动素材ID dGVzdA= 为站长填写的反馈数据（经过base64编码）10026001_287_0_dGVzdA= 10026002_287_0_dGVzdA= 10026 为站长在多麦的用户ID 001/002 为站长的网站编号287 为商家在多麦的活动ID 0 为商家在多麦的