ecshop整合返利网CPS接口文档

一时失言乱红尘 2022-09-28 15:27 163阅读 0赞

[ecshop][]整合返利网[CPS接口文档][CPS]  
一、 B2C（商家）需提供广告链接请求地址  
1、商家（B2C）需提供广告链接请求地址，点击广告后进入到商家的页面，商家提供的广告链接样式比如：http://www.dangdang.com/cps/cpsRecord.action  
在用户点击返利网上的B2C广告，跳转到B2C页面的同时会通过get方式带过去channelId 、u\_id、url三个参数  
广告链接示例：  
http://www.dangdang.com/cps/cpsRecord.action?channelId=51fanli&u\_id=返利网会员编号(默认为6)&url=http://www.dangdang.com/index.html

本链接注释：  
网站链接：http://www.dangdang.com/cps/cpsRecord.action  
目标链接：http://www.dangdang.com/index.html

参数说明：  
参数名称 含义 备注  
channelId 返利网标识 返利网在商家广告主的唯一标识，此文本值可以由商家自行定义（文本，固定值）  
u\_id 返利网用户ID 返利网上的会员ID。  
url B2C商家链接 商家网站的目标url，可为前台任意页面（点击该链接跳转到商家指定的页面，变量）

注：上述三个参数格式均为字符串型；三个参数可以根据各商家的网站需求自行定义名称

2、 当用户点击广告链接到B2C页面后，channelId的值可作为判断“订单来源”的依据，B2C通过cookie记录获取channelId、u\_id参数的值（cookie的有效期不低于30天），在用户生成订单后，B2C需要将该用户的channelId、u\_id参数值保存到订单的数据库中。

注：如果广告链接上面的url参数为空，则本链接跳转到B2C网站设置的默认landing页（一般为B2C首页），如果有URL参数则跳转到该URL

二、 设置广告效果认证期（RD认证期）  
说明：  
用户第一次通过返利网上的广告链接跳转到B2C网站，在一定期限之内（如：cookie有效期内），即使用户没有通过返利网上的广告链接前往B2C网站，而是直接登陆B2C下订单，此种情况下产生的业绩也属于返利网。当超过此段期限后，直接登陆B2C网站下的订单将不算作返利网的业绩。这个时间段称为RD认证期。  
B2C方面需要在程序中按合同内容设定网站主的效果认证期（RD认证期）。  
(根据双方签署的合同，RD认证期一般为30天，可以通过设定客户端cookie的有效期为30天来实现这一功能)

三、订单数据传输方式  
1、 发送订单信息  
当用户在B2C网站上下订单的时候，在订单生成页检测COOKIE，判读是否来自返利网和返利网的用户编号，如果有，则调用订单数据发送程序，将订单信息传递到返利网指定的订单数据接收页面。（这一步需在订单号生成后即做，不可以放在付款后）

调用格式：以Get方式调用，示例如下：  
http://data.51fanli.com/union/fanliorder.asp?otime=2009-9-1 9:10:1&o\_cd=10005276&m\_id=m\_id&k=123456&u\_id=6&p\_cd=21312|\_|&c\_cd=A|\_|&it\_cnt=1|\_|&price=160|\_|&comm=22|\_|

把此段代码放置到订单生成成功页面，生成订单后调用该段代码即可把订单数据传送到返利网：  
<img src=” http://data.51fanli.com/union/fanliorder.asp?otime=2009-9-1 9:10:1&o\_cd=10005276&m\_id=m\_id&k=123456&u\_id=6&p\_cd=21312|\_|&c\_cd=A|\_|&it\_cnt=1|\_|&price=160|\_|&comm=22|\_|” width=1 height=1 />

\------M\_id   B2c方 网站域名。 如：www.baidu.com     m\_id=baidu

注：当一条订单中含有一种或多种商品时，则商品的p\_cd(商品编号)、price（商品单价）、comm（佣金）、c\_cd（商品归属类所在的分类编号）、it\_cnt（商品数量）这些参数的每个值用符号|\_|结尾。  
   例：一个订单里有2种商品，商品1和商品2，他们的单价分别是单价1和单价2，分类编号是分类1和分类2，数量是数量1和数量2，佣金则分别是佣金1和佣金2，其中佣金的算法是：商品单价\*佣金比例\*商品数量。这样 ，p\_cd=商品1|\_|商品2|\_| , price=单价1|\_|单价2|\_| , comm=佣金1|\_|佣金2|\_| , c\_cd=分类1|\_|分类2|\_| , it\_cnt=数量1|\_|数量2|\_| 参数 没有的填0  
实时订单数据参数说明（黄色标识项必须要有数据）：  
参数名称 值类型 描述说明  
otime date 下定单的具体时间  
o\_cd string 定单号  
m\_id string 商城代号(一般为网站英文名称 如：baidu）  
u\_id int 用户标示（返利网会员ID，广告链接传入参数）  
p\_cd string 商品编号.  
it\_cnt string 商品数量  
price string 商品单价  
c\_cd string 分类编号(返利率 分类)  
comm string 佣金（如果无可写0）  
k string 网站识别码（返利网提供固定值123456）

2、订单数据查询接口  
作用：返利网通过接口地址，读取返利网会员在B2C商家网站上所下的订单详情  
接口地址格式，如：http://www.dangdang.com/queryData.action?date=2008-9-1&unionid=51fanli  
Date为查询日期，格式为yyyy-MM-dd  
此接口将以文本形式输出订单数据，格式如下：  
otime|o\_cd|u\_id|p\_cd|c\_cd|it\_cnt|price|comm|m\_id|\_|otime|o\_cd|u\_id|p\_cd|c\_cd|it\_cnt|price|comm|m\_id|\_| 。。。循环

说明：  
一条订单有几种商品就几条数据  
此接口数据为实时订单数据。出于数据量传输等原因的考虑，queryData.action可以按天进  
行查询，便于进行统计汇总工作。

3、对于一个订单中有多种商品或一种商品都显示一条记录  
例子（以asp代码为例）  
广告主：e生活  
广告链接：http://www.ebuyba.com/jump.asp? channelId=51fanli&u\_id=6&url=http://www.ebuyba.com  
http://www.ebuyba.com/jump.asp

jump.asp页面代码：  
<%  
Source=request(“channelId”)  
U\_id=request(“u\_id”)  
url=request(“url”)  
response.cookies(“source”)=source  
response.cookies(“u\_id”)=u\_id  
response.redirect(url)’跳转到指定页面  
‘可以根据合同设置cookie有效期  
%>  
\--  
订单生成后的停留页面 添加代码：

1 一条订单一种商品  
<%  
If request.cookies(“source”)=”51fanli” then ‘判断是否是来自返利网  
Otime=now()  
O\_cd=订单号’会员所下的订单（变量）  
M\_id=ebuyba’返利网分配（固定值）  
K=123456’返利网分配（固定值）  
U\_id=request.cookies(“u\_id”)  
P\_cd=1&”|\_|”  
C\_cd=1&”|\_|”  
It\_cnt=1&”|\_|”  
Price=10.00&”|\_|”  
’分类1的返利比例为16%  
Comm=10.00\*0.16  
Response.write(“<script src=’http://data.51fanli.com/union/fanliorder.asp?otime=”&otime&”&o\_cd=”&o\_cd&”&m\_id=”&server.urlencode(m\_id)&”&k=”&123456&”&u\_id=”&u\_id&”&p\_cd=”&p\_cd&”&c\_cd=”&c\_cd&”&it\_cnt=”&it\_cnt&”&price=”&price&”&comm=”&comm&”’></script>”)  
End if  
%>

2 一条订单多种商品  
‘订单号 o\_cd=564587545  
   ’分类53的返利比例是10%  
   ’分类21的返利比例是5%  
‘商品1 p\_cd=1 it\_cnt=3 c\_cd=53 price=20.00 Comm=20.00\*0.10=2.00  
‘商品2 p\_cd=2 it\_cnt=5 c\_cd=21 price=12.00 Comm=12.00\*0.05=0.60

<%  
If request.cookies(“source”)=”51fanli” then ‘判断是否是来自返利网  
Otime=now()  
O\_cd=订单号’会员所下的订单（变量）  
M\_id=ebuyba’返利网分配（固定值）  
K=123456’返利网分配（固定值）  
U\_id=request.cookies(“u\_id”)

‘商品1和2  
P\_cd=1|\_|2|\_|  
C\_cd=53|\_|21|\_|  
It\_cnt=3|\_|5|\_|  
Price=20.00|\_|12.00|\_|  
Comm=2.00|\_|0.60|\_|

Response.write(“<script src=’http://data.51fanli.com/union/fanliorder.asp?otime=”&otime&”&o\_cd=”&o\_cd&”&m\_id=”&server.urlencode(m\_id)&”&k=”&123456&”&u\_id=”&u\_id&”&p\_cd=”&p\_cd&”&c\_cd=”&c\_cd&”&it\_cnt=”&it\_cnt&”&price=”&price&”&comm=”&comm&”’></script>”)  
End if  
%>

4 例子（.net(c\#)）

广告主：e生活  
广告链接：http://www.ebuyba.com/jump.aspx? channelId=51fanli&u\_id=6&url=http://www.ebuyba.com

http://www.ebuyba.com/jump.aspx页面代码：

<%  
string channelId=Request.QueryString\["channelId"\];  
string u\_id=Request.QueryString\["u\_id"\];  
string url=Request.QueryString\["url"\];

//可以根据合同设置cookie有效期(一般30天)  
Response.Cookies\["channelId"\].Value=channelId;  
Response.Cookies\["channelId"\].Expires = DateTime.Now.AddDays(30);

Response.Cookies\["u\_id"\].Value=u\_id;  
Response.Cookies\["u\_id"\].Expires = DateTime.Now.AddDays(30);

if(url==""||url==null)\{url="/";\}  
Response.Redirect(url);//跳转到指定页面  
%>

订单生成后停留页面 添加代码：  
<%  
//判断是否是来自返利网  
if(Request.Cookies\["channelId"\].Value=="51fanli")  
\{  
String otime=DateTime.Now.ToString();                    ;  
String o\_cd=订单号; //会员所下的订单（变量）  
String m\_id=ebuyba; //返利网分配（固定值）  
String k=123456; //返利网分配（固定值）  
String u\_id=Request.Cookies\["u\_id"\].Value;  
String p\_cd=1+”|\_|”;  
String c\_cd=1+”|\_|”;  
String it\_cnt=1+”|\_|”;  
String price=订单金额+”|\_|”;  
String comm=price\*佣金比例+”|\_|”;  
Response.Write("<script src='http://data.51fanli.com/union/fanliorder.asp?otime="+otime+"&o\_cd="+o\_cd+"&m\_id="+m\_id+"&k="+k+"&u\_id="+u\_id+"&p\_cd="+p\_cd+"&c\_cd="+c\_cd+"&it\_cnt="+it\_cnt+"&price="+price+"&comm="+comm+"'></script>");  
\}  
%>

四、测试  
   B方 发送测试链接给我们 , 并通过该链接下一个单,发订单号让我们查一下是否跟到

[ecshop]: http://www.chinab4c.com/
[CPS]: http://www.chinab4c.com/html/shangchengchengxu/ecshopchangjianwenti/2010/0901/690.html