jdKepler
来自于:APICloud立即使用
概述
jdKepler 模块封装了京东开普勒导购模式SDK,在合作方的APP里嵌入京东的货架,由合作方引流至该货架,并形成闭环交易。和传统广告佣金模式对比将整套交易流程进行闭环,可提升客户体验,并提高订单转换率,享受完整的京东标准的配送和售后服务体系。开普勒导购模式能力开通流程
使用此模块之前必须先配置 config 文件,配置方法如下:
- 名称:jdKepler
- 参数:appKey_iOS、appSecret_iOS、urlScheme、appKey_android、appSecret_android
- 配置示例:
<feature name="jdKepler">
<param name="appKey_iOS" value="a1a079063f304ad18a290102e07a850d" />
<param name="appSecret_iOS" value="7faaab98b3d94f7baef0bbe8041fe28a" />
<param name="appKey_android" value=""/>
<param name="appSecret_android" value=""/>
<param name="urlScheme" value="sdkbacka1a079063f304ad18a290102e07a850d" />
</feature>
字段描述:
appKey_iOS:京东开普勒平台创建应用的APP Key appSecret_iOS:京东开普勒平台创建应用的APP Secret appKey_android:京东开普勒平台创建应用的android APP Key appSecret_android:京东开普勒平台创建应用的android APP Secret urlScheme:用于实现应用间跳转及数据交换,urlScheme 的 value 值为sdkback+你的appKey_iOS
iOS 平台上添加白名单,如下: ```xml <preference name="querySchemes" value="openapp.jdmobile,jdlogin,weixin" /> ```
iOS 平台注意: 在 管理平台 点击 SDK下载,输入iOS应用的BundleID,生成并下载SDK,将SDK打包成一个附加自定义模块上传 APICloud 平台。制作方法如下:下载 jdKeplerAppendix 模块 zip 包并解压,把 zip 包内 target 目录下的 JDKeplerSDK.framework 和 Kepler.bundle 文件替换为自己从京东开普勒平台获取的SDK。然后重新压缩为 zip 包文件上传自定义模块,云编译时勾选该模块。
注意: android 除了要配置上面的 appKey & keySecret 之外还需要使用安全图片,具体操作流程如下:
- 到京东开普勒平台创建应用 传送门
- 创建应用后在 “应用概览” 中可查看 appKey & keySecret
- 在“sdk下载”中下载sdk,注意此处需要上传需要使用sdk的apk,(主要进行apk包名 & 签名验证)
- 解压下载的sdk,在jdsdk_lib\src\main\res\raw 目录下找到 safe.jpg(即安全图片)
- 下载配置模块 jdKeplerConfig,如果模块版本为1.0.4+, 下载自定义模块jdKeplerConfigV1,解压后将模块中的jdkepler_module-release.aar,如果模块版本为1.0.4+,解压文件jdkeplerconfig-release.aar(.aar文件可以使用标准解压软件解压,如360解压缩软件等) 文件再次解压,将上一步的安全图片放置在 res\raw 目录下即可(没有raw目录自己创建),再将jdkepler_module-release目录下的AndroidManifest.xml中的
<activity
android:exported="true"
android:name="com.kepler.jd.sdk.KeplerBackActivity"
android:theme="@android:style/Theme.Translucent">
<intent-filter>
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.DEFAULT"/>
<data android:scheme="sdkbackc49b61cd6cb50123641e01e5a19cc0bb"/>
</intent-filter>
</activity>
data 的标签用sdk目录下 src\main中的data标签替换掉,然后再次打包aar(选中(res,AndroidManifest.xml,classes.jar,R.txt)这些文件,然后压缩成zip格式并重命名为aar格式),最后再压缩为 jdKeplerConfigV1.zip,然后将jdKeplerConfigV1模块以自定义模块的形式(上传自定义模块后要点击加号)与jdKepler一块编译即可。
init
初始化sdk。 此接口仅支持Android。
init(callback(ret))
callback(ret)
ret:
- 类型:JSON 对象
- 内部字段:
{
success: true, //布尔类型;初始化是否成功
}
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.init(function(ret){
alert(JSON.stringify(ret));
});
可用性
Android系统
可提供的1.0.0及更高版本
login
登录授权
login(callback(ret))
callback(ret)
ret:
- 类型:JSON 对象
- 内部字段:
{
success: true, //布尔类型;是否成功
}
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.login(function(ret){
alert(JSON.stringify(ret));
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
cancelAuth
取消授权
cancelAuth()
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.cancelAuth();
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
openByH5
是否强制使用H5打开界面
openByH5({params})
params
h5:
- 类型:布尔类型
- 描述:是否强制使用H5打开界面,设置为false时,调用商品详情页,订单列表,购物车等方法时将跳转到京东app并打开对应的界面
- 默认:true
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.openByH5({
h5 : false
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
openPage
通过URL打开任意商品页面
openPage({params})
params
url:
- 类型:字符串类型
- 描述:(可选项)页面url
- 默认:打开京东商城首页
jumpType:
- 类型:数值类型
- 描述:(可选项)跳转类型 1代表present 2代表push
- 默认:2
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.openPage({
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
openDetail
通过SKU打开Kepler单品页
openDetail({params})
params
sku:
- 类型:字符串类型
- 描述:商品SKU
- 默认:无
jumpType:
- 类型:数值类型
- 描述:(可选项)跳转类型 1代表present 2代表push
- 默认:2
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.openDetail({
sku : '1152042'
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
openOrderList
打开订单列表
openOrderList({params})
params
jumpType:
- 类型:数值类型
- 描述:(可选项)跳转类型 1代表present 2代表push
- 默认:2
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.openOrderList({
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
openNav
打开导航页
openNav({params})
params
jumpType:
- 类型:数值类型
- 描述:(可选项)跳转类型 1代表present 2代表push
- 默认:2
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.openNav({});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
openSearch
根据搜索关键字打开搜索结果页
openSearch({params})
params
searchKey:
- 类型:字符串类型
- 描述:搜索关键字
- 默认:无
jumpType:
- 类型:数值类型
- 描述:(可选项)跳转类型 1代表present 2代表push
- 默认:2
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.openSearch({
searchKey : 'macbookPro'
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
openShoppingCart
打开购物车界面
openShoppingCart({params})
params
jumpType:
- 类型:数值类型
- 描述:(可选项)跳转类型 1代表present 2代表push
- 默认:2
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.openShoppingCart({
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
addToCart
添加到购物车
addToCart({params},callback(ret,err))
params
sku:
- 类型:字符串类型
- 描述:商品sku
- 默认:无
num:
- 类型:字符串类型
- 描述:(可选项)商品数量
- 默认:1
callback(ret,err)
ret:
- 类型:JSON 对象
- 内部字段:
{
success: true, //布尔类型;是否成功
}
err:
- 类型:JSON 对象
- 内部字段:
{
code: 1, // 数值类型;错误code
}
示例代码
var jdKepler = api.require('jdKepler');
jdKepler.addToCart({
sku : '1152042',
num : '2'
},function(ret,err){
if (ret.success) {
alert(JSON.stringify(ret));
}else {
alert(JSON.stringify(err));
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本