电商服务
轻电商JS(Link-SDK)使用指南
更新时间：2018/05/06
访问次数：30026
概述
为配合客户端SDK改造升级，轻电商JS（原名JS-SDK）现改为Link-SDK，简称linksdk。
改造后将获得：
* 对需求多样性更好的支持，避免接入开发者在满足不了需求的时候自己拼协议。
* 更好的稳定性。
轻电商
快速集成实现电商场景，以更低成本、有效率探索电商合作模式
产品简介
通过轻电商实现商业变现
- 轻电商无须接入SDK, 即可实现电商选品与交易闭环, 快速搭建电商业务
- 轻电商接入不受限于APP, 开发者皆能轻松创建电商场景
客户价值
- 低成本高效率, 节省集成时间
- 多样式开发, 带来流量和销量
- 丰富营销工具，提升用户粘性
demo演示 (由于微信屏蔽了taobao域，请用其他带扫码功能的工具打开)
demo参考地址：点击查看 。
引入
在页面引入linksdk
<script type="text/javascript" src="//g.alicdn.com/mtb/lib-applink/0.3.8/??callApp.js,linksdk.js"></script>
初始化linksdk
使用linksdk需要先初始化，传入appkey和相关参数作为全局默认参数。
window.BC_SDK = BCSDK_AppLink.init({
appkey : '23082328', //必填，输入百川应用的appkey
backURL: 'tbopen7663://', //必填，默认为空字符串，applink的tips的回跳url， 设置能在手机淘宝里面调回你自己应用的url，格式为`tbopen${appkey}`。
openApp: true, //非必填，默认为true，非必填，是否唤起客户端，设置false，只会做H5跳转。
linkKey: 'TB', //非必填，默认为TB, 唤起手淘(TB)/天猫(TM)。
isNeedDownload: false, //非必填，默认为false, 没有app的情况下跳转目标h5页面还是下载页, 默认跳转目标h5页面。
isDefaultRedirect: true, //选填, 没有唤起app的情况下是否默认跳转, 默认true。
params:{}, //非必填，带给applink协议的扩展参数,用户自定义参数也传在这里, 如scm、pvid、pid、subpid、e、unionId等业务参数会放到这里。
trackParams:{}, //非必填，ybhpss的映射对象，传入这里的参数会被拼为ybhpss字符串带到协议上。
timeout: 1000 // 非必填，默认跳转(目标h5页/下载页)的延时时长。
});
扩展参数params
| 参数名 | 参数含义 | 备注 |
|---|---|---|
| pid | 淘客参数 | 百川pid获取方式：点击查看 |
| scm | 混合推荐参数 | |
| pvid | 混合推荐参数 |
使用方法一：JS-API方法
1.打开详情页
使用初始化实例对象的goDetail方法，传入关键参数itemId即可。
示例代码：
window.BC_SDK.goDetail({
itemId : '521376186545',
params : {}
});
2.打开店铺页
使用初始化实例对象的goShop方法，传入关键参数shopId即可。
示例代码：
window.BC_SDK.goShop({
shopId : '64809422',
params : {}
});
3.打开淘客链接
使用初始化实例对象的goTaoke方法，传入关键参数tkUrl即可。
注意：淘客关键参数pid一定要传对才可以参与分佣。
示例代码：
window.BC_SDK.goTaoke({
tkUrl : '//s.click.taobao.com/ItYlcXx',
params : {
pid: "xxx", // 淘客必填
subpid: "xxx",
unionId: "xxx"
}
});
4.打开URL
使用初始化实例对象的gotoUrl方法，传入关键参数url即可。
示例代码：
window.BC_SDK.gotoUrl({
url : '//h5.m.taobao.com/awp/core/detail.htm?id=539488475784',
params : {}
});
5.在天猫中打开
传入关键参数linkKey=TM即可。
示例代码：
window.BC_SDK.gotoUrl({
url : '//pages.tmall.com/wow/act/15933/zhuangban',
linkKey: 'TM',
params : {}
});
使用方法二：通过监听a标签点击的方法
| 属性名 | 是否必传 | 说明 | 示例值 |
|---|---|---|---|
| data-type | 是 | 被监听为linksdk tag的标识 | bc_applink |
| data-itemid | data-itemid，data-shopid，data-taoke，href 可传其中之一 | 商品ID | 532108773369 |
| data-shopid | data-itemid，data-shopid，data-taoke，href 可传其中之一 | 店铺ID | 33810873 |
| data-taoke | data-itemid，data-shopid，data-taoke，href 可传其中之一 | 淘客链接 | //s.click.taobao.com/tgdYQXx |
| href | data-itemid，data-shopid，data-taoke，href 可传其中之一 | h5页面url | //h5.m.taobao.com |
| data-params | 可选 | 扩展字段，必须使用标准json字段。 | JSON.stringify([object]) |
注：引入js 和初始化步骤必须完成。
1.打开详情页
<a href="//m.taobao.com" data-type="bc_applink" data-appkey="23082328" data-itemid="44777395102" data-params='{"bc_test":"01"}'>去详情</a>
2.打开店铺页面
<a href="//m.taobao.com" data-type="bc_applink" data-shopid="71326078" data-params='{"bc_test":"02"}'>去店铺</a>
3.打开淘客链接
<a href="//m.taobao.com" data-type="bc_applink" data-taoke="//s.click.taobao.com/ItYlcXx" data-params='{"bc_test":"0"}'>去淘客</a>
4.打开url
<a href="//taoquan.taobao.com/coupon/unify_apply.htm?sellerId=531557864&activityId=2d0d8b9b7d3f40ce81447d70df1efcd0" data-type="bc_applink" data-params='{"bc_test":"04"}'>去活动</a>
补充说明
h5 url 跳转会将扩展参数拼接在跳转的url后面，参数冲突情况，由扩展参数覆盖原url后带的参数，参数进行encode处理。
扩展参数params， 如果单独调用会覆盖全局初始化的值，不单独调用会继承全局初始化的值。
订单消息通知使用说明：点击查看 。
更新记录
- V0.3.8 更新下载页链接
- V0.3.6 增加唤端限制逻辑,如果页面所在环境是目标协议页面的目标环境,则不触发唤起协议
- V0.3.5 调整在aliapp上使用唤醒的方法。
- V0.3.4 修复goDetail、goShop、goTaoke方法，跳入手淘后，H5默认跳转到详情、店铺页重复唤起手淘，导致小把手丢失的问题。
- V0.3.3 修正backURL参数重复encode的问题。
- V0.3.2 修改埋点参数。
- V0.3.1 修复timeout默认参数丢失的问题。
