jdUnion
概述
本模块封装了CPS联盟SDK呼起京东APP功能,CPS联盟是京东联合广大媒体合作伙伴推广京东商品、提高各品牌知名度的重点营销平台,现为第三方应用开发者提供SDK,帮助第三方应用在进行京东商品、活动等推广过程中,为用户带来更好的产品体验,实现提高转化率、拉动商业变现的目标。
使用此模块之前必须先配置 config 文件,配置方法如下:
- 名称:jdUnion
- 参数:urlScheme
- 配置示例:
<feature name="jdUnion">
<param name="urlScheme" value="" />
</feature>
字段描述:
urlScheme:(必须配置)用于实现应用间跳转,内容为 sdkback + 对应使用方的appKey
使用本模块前要在config文件配置可被检测的URL Scheme,否则无法跳转
<preference name="querySchemes" value="jdlogin,openapp.jdmobile" />
在部分京东页面需要访问相机和相册,因此需要在编译时勾选相机和相册权限。
注意:本模块 iOS 平台上最低适配系统版本为 iOS 8.0
Android 端配置说明
Android 需要配置安全图片,配置如下:
- 登录京东联盟开放平台
- 在“我的推广-推广管理-APP管理”中新建应用
- Andriod应用在下载SDK之前,需要完善signmd5、SHA1信息;(可以通过小工具快速查看signmd5、SHA1值,点击 下载 小工具)
- 点击下载SDK,将SDK下载到您的本地浏览器中,根据接入说明嵌入SDK即可
- 在sdk包中找到 safe.jpg
- 下载自定义模块 jdUnionConfig
- 解压模块包,将safe.jpg 放入目录 jdUnionConfig\res_jdUnionConfig\res\raw 下即可
- 将 jdUnionConfig 上传为自定义模块与jdUnion 模块一起编译即可
iOS安全图片 iOS端需要制作自定义模块包用于上传安全图片
制作方法如下:
下载 jdUnionAppendix 模块 zip 包并解压,把 zip 包内 target 目录下的 JDSDK.bundle 文件替换为自己从京东联盟开放平台获取的JDSDK.bundle文件。然后重新压缩为 zip 包文件上传自定义模块,云编译时勾选该模块。
init
注册 Kepler 服务
init({params},callback(ret))
params
appKey:
- 类型:字符串类型
- 描述:注册的appKey,京东联盟平台获取
appSecret:
- 类型:字符串类型
- 描述:注册的secretKey京东联盟平台获取
callback(ret)
ret:
- 类型:JSON 对象
- 内部字段:
- 说明:iOS可能会多次返回
{
status: //布尔类型;是否成功
}
示例代码
var jdUnion = api.require('jdUnion');
jdUnion.init({
appKey:'',
appSecret:''
},function(ret){
alert(JSON.stringify(ret));
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
openKeplerPageWithURL
跳转京东app
openKeplerPageWithURL(callback(ret))
params
url:
- 类型:字符串类型
- 描述:url
- 注意:注:如需要通过 SDK 呼起京东 APP 首页,请使用如下 url 转链后,再调用 SDK 呼起: https://m.jd.com/?isopen=1&ad_od=1&allowJDApp=1
userInfo:
- 类型:json对象
- 描述:kepler自定义参数
callback(ret,err)
ret:
- 类型:JSON 对象
- 内部字段:
- 说明:iOS可能会多次返回
{
status:false, //布尔类型;是否成功 (Android 不支持)
code:0 //数字类型;执行状态;取值范围如下:
// 0 => OpenAppAction_result_APP
// 1 => OpenAppAction_start
// 2 => OpenAppAction_result_ErrorScheme
// 3 => OpenAppAction_result_NoJDAPP
// 4 => OpenAppAction_result_BlackUrl
// -1100 => OpenAppAction_result_NetError
}
err:
- 类型:JSON 对象 (Android不支持)
- 内部字段:
{
code:0, //数字类型;错误编码
url:'' //字符串类型;引起调用失败的url
}
示例代码
var jdUnion = api.require('jdUnion');
jdUnion.openKeplerPageWithURL({
url:'',
userInfo:{}
},function(ret){
alert(JSON.stringify(ret));
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本