热门搜索: 物流跟踪 自定义URL oauth2.0 银联
当前位置: 我的shopex插件站 > ShopEx技术分享 >
热点内容
本站推荐
详细内容

shopex二次开发之一淘CPS返利接口

时间:2012-02-28 18:09 来源:未知 作者:admin 点击: 次

shopex二次开发之一淘CPS返利接口：

 


  用户点击一淘联盟提供的B2C推广链接后，一淘联盟将完成反作弊、点击跟踪、人群识别等一系列操作，并向B2C网站传递三个参数：source、ali_b2ctrackid、ali_crowd，以告知B2C网站当前用户由一淘联盟引导和当前用户特征，并由B2C完成后续的CPS订单跟踪。

         B2C跳转参数标准格式，如下所示：

B2Curl?Source=[alimama]&SourceSunInfo=[B2CTrackID]&ali_crowd=[crowd]

参数说明：

Source           :  标识一淘联盟，由B2C提供。

B2Curl           :  B2C通过此URL跳转完成CPS订单跟踪布点（如：种植cookie）。

SourceSunInfo           ：     一淘联盟提供的B2C订单跟踪id（ali_b2ctrackid），在交易中必须回传该参数。

ali_crowd                            ：     当前点击用户所属人群（需开通权限），未开通权限时此字段为空。

以凡客为例，ali_b2ctrackid类似于凡客提供的SourceSunInfo参数。如下所示：

http://www.vancl.com/?Source=[alimama]&SourceSunInfo=[B2CTrackID]&ali_crowd=[crowd]


一淘联盟B2C订单回传采用主动获取方式。一淘联盟TradeDataCrawler负责定期从B2C网站获取CPS交易相关信息。这些交易，都是B2C站点认定的合法的CPS交易。TradeDataCrawler通过HTTP协议从B2C网站CPS订单接口获取这些交易记录，同时将这些交易记录转发给ExtTradeCenter模块。

每个B2C提供交易数据的地址或者参数形式可不相同，但这些接口需要支持下述语义，请求串示例如下：

http://ext-b2c-site-trade-data-addr/?s=[beginTimeStamp]&e=[endTimeStamp]&u=[user_id]&sign=[sign]&status=[status]

请求串中的各个参数具体含义如下：

参数名称

含义

示例

备注

s

起始时间戳，单位为秒

1316518460

必选，闭区间

e

结束时间戳，单位为秒

1316518461

必选，开区间

u

淘宝联盟在B2C站点申请的推广者id

Alimama（对应于source）

必选，若为一淘联盟专属接口则可不需要

sign

完整性校验参数

md5(u + key + s + e)；

u：凡客提供的source；

key：凡客提供的key；

s：开始时间戳；

e：结束时间戳；

必选，保证请求的合法性，每个用户只能获取到自身的交易数据。生成规则请见下文sign生成规则。

status

订单状态

N

可选。可选值参考1.1.2.2中中status字段的定义。默认为返回全部状态的订单。

注意事项：

  1. s和e形成一个时间区间，s是闭区间，而e是开区间，即[s,e )，B2C网站需要返回在这个区间中符合条件的交易数据。
  2. sign的生成规则如下：md5(u + key + s + e)；

u：凡客提供的source；

key：凡客提供的key；

s：开始时间戳；

e：结束时间戳；

{"version":"1.00",

 "retcode":0,

"count":2,

 "trades":[ {"gmtTimeStamp":1320630323,

           "createTimeStamp": 1320630323,

           "orderId":12345678,

          "itemId":1001,

          "price":1000,

          "quantity":1,

           "b2cTrackId":"abc1122",

           "status":"N",

           "commGroupId":"100",

           "commExtraInfo":"5",

           "itemTitle":"test item",

           "tradeInfo":""

         },

          {"gmtTimeStamp":1320630323,

           "createTimeStamp": 1320630323,

           "orderId":12345678,

          "itemId":1002,

          "price":1000,

          "quantity":1,

           "b2cTrackId":"abc1122",

           "status":"N",

           "commGroupId":"100",

           "commExtraInfo":"5",

           "itemTitle":"test item",

           "tradeInfo":""

         }]

}


(责任编辑：admin)
标签：shopex接口二次开发一淘CPS返利
上一篇：shopex二次开发之品牌筛选搜索功能（可按拼音首字母、名称全匹配方式） 下一篇：shopex二次开发之后台商品列表显示缩略图，方便管理员

湘公网安备 43010202000614号