ecshop整合返利网CPS接口文档

    ecshop整合返利网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整合成果cps接口

   ecshop2.7.0集成亿起发cps接口

   ecshop集成adlady的cps接口

来源：http://www.chinab4c.com