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" />

在部分京东页面需要访问相机和相册,因此需要在编译时勾选相机和相册权限。

注意:本模块 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 模块一起编译即可

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