5.8 支付宝小程序 SDK 接入说明

支付宝小程序 SDK 部署文档

1. 支付宝小程序后台为小程序添加合法域名：

jice.fw4.me
ac.jice.io

2. 引入 JS

// 具体引入目录根据实际情况调整
import jice from './jice.min.js'

将下载的 SDK 文件放入对应的目录下，且在 app.js 中引入；

下载支付宝小程序 SDK（无框架版、支付宝小程序 SDK（框架版）

3. 初始化

在 app.js App 对象的 onLaunch 方法中调用 init 进行初始化

// 小程序ID请更新为支付宝小程序官方分配的ID
// Jice_APP_ID，请更新为Jice系统分配应用ID
// options 传递onLaunch 的`options`参数
jice.init("小程序ID", "Jice_APP_ID", options)
jice.setVersion('小程序业务代码版本')
// 可选,获取用户地理位置（经纬度）
jice.openGetLocation()

Jice_APP_ID 通过及策系统中创建应用后在【管理】-【应用管理】查看

4. 设置 jice 全局变量

在 app.js App 对象中注册 jice 为全局对象

App({
  jice: jice
})

在每个组件中可以通过getApp().jice进行引用；

5.设置每个Page的名称

由于我们会自动获取每个页面的浏览信息，为了您在分析的时候更加直观，请为每个 Page 定义页面名称，在每个 page 增加以下代码，若不定义，则页面标题为空；

Page({
    jicePageTitle: "首页"
})

6. 注册用户信息 addUserIdentifier

当获取到用户信息后可以随时通过调用以下接口设置用户信息，以便按用户来分析每个用户的互动情况；（每次设置的信息可不同，最终的用户信息会是所有设置的并集，后设置的相同字段会覆盖以往设置的相同字段）

// 可以根据实际情况变更
jice.addUserIdentifier({
  avatar: "/*value*/", // 头像地址
  city:"杭州市",
  countryCode:"CN",
  gender:"m",
  nickName:"null",
  province:"浙江省"
})

7.设置userId 为用户唯一识别id

在获取到用户的 userId 之后调用以下代码，即可设置用户的 userId 为唯一识别ID；

// 设置支付宝小程序获取的 userId
jice.setUserId(userId)

8. 用户来源追踪

对于用户来源，在初始化过程中已经做了识别，自动会获取小程序路径参数来识别用户从哪里来(如扫描哪个二维码)。因此在生成二维码、推广、分享时按照如下规则生成页面路径：

• 按照如上规则，生成后页面路径样为：pages/index?md=Qr_code&pl=mendian_a
• md 和 pl 参数可全部设置，也可只设置一个，也可全部都缺省；

9. 自定义事件跟踪

// eventKey: 要追踪的事件 key；
// eventAttrs: 事件属性，可以缺省；
jice.track(eventKey, eventAttrs)

//有事件属性
jice.track(eventKey, {
 eventLabel: /*value*/
})

//无事件属性
jice.track(eventKey)

//例：监测提交表单
jice.track("SubmitSuccess", {  //表单提交成功
  id: "20170101",     //表单唯一id
  name: "venny"   //用户名
})    
//例：监测互动
jice.track("aboutUs")

场景示例：分享监测

Page({
  onShareAppMessage() {
    jice.track("onshare", {    
      title: "自定义分享标题", 
      path: "/page/user" + "md=share&pl=" + app.globalData.userInfo.nickName  
    })
  }
})

注：如果需要进行细化追踪分享者的影响效果，则可以在 path 后动态加上用户动作名称的昵称，这样就可以统计该分享者最终带来多少用户了。