jdUnion

立即使用

init openKeplerPageWithURL

概述

本模块封装了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 需要配置安全图片，配置如下：

    1. 登录京东联盟开放平台
    1. 在“我的推广-推广管理-APP管理”中新建应用
    1. Andriod应用在下载SDK之前，需要完善signmd5、SHA1信息；（可以通过小工具快速查看signmd5、SHA1值，点击 下载 小工具）
    1. 点击下载SDK，将SDK下载到您的本地浏览器中，根据接入说明嵌入SDK即可
    1. 在sdk包中找到 safe.jpg
    1. 下载自定义模块 jdUnionConfig
    1. 解压模块包，将safe.jpg 放入目录 jdUnionConfig\res_jdUnionConfig\res\raw 下即可
    1. 将 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：

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及更高版本