支付宝小程序 SDK

支付宝小程序 SDK

配置SDK安全域名

登录支付宝小程序管理后台，在「设置-开发设置-服务器域名白名单」中，增加诸葛域名：

https://u.zhugeapi.net

https://ubak.zhugeio.com

若是私有部署客户，服务器域名需要配置自己的域名。

安装SDK

安装SDK依赖npm install zg-sdk-ali --save-dev

引用SDK

1.在小程序项目的app.js文件中，引入SDK

import 'zg-sdk-ali'
App.zhuge.load('appKey', { // 选填
  debug: false, // 开启实时调试
  serverUrl: { // 数据上传地址
    normal: 'https://u.zhugeapi.net', // 数据上传主地址
    bac: 'https://ubak.zhugeio.com' // 数据上传备用地址
  },
  timeout: 1800000, // 会话超时时间（默认30分钟）
  did: '', // 自定义设备id
  vn: '1.0', // 小程序应用版本
  pv: false, // 是否启用页面访问统计功能，会在生命周期OnShow中自动采集页面访问事件
  click: flase, // 是否⾃动上报click 默认关闭
  eid:'' // 小程序appid（可在支付宝开放平台查看）
})
App({
  ...
});

2.记录用户行为

在需要记录用户行为的部分，调用如下方法：

App.zhuge.track('eventName', {
    '属性名称': '属性值' // 自定义事件属性
})

例如：

App.zhuge.track('加入购物车', {
    '商品名称': '华为P30'
})

注意：在添加事件属性时，需注意事件属性类型。如果事件属性类型为「数值型属性」，需要上传数据时修改数据类型为「数值型」，并且在诸葛io后台埋点管理中修改为「数值型」。

3.绑定用户信息

为了保持对用户的跟踪，你需要为他们记录一个识别码，可以使用手机号、email等唯一值来作为用户的识别码。另外，也可以在跟踪用户的时候， 记录用户更多的属性信息，便于你更了解你的用户：

App.zhuge.identify('user_id', {
    '属性名称': '属性值' // 自定义用户属性
})

以手机号为用户id举例：

App.zhuge.identify(17700000000, {
    '姓名': '张三'
})

4.记录收入数据采集

记录收入数据采集，需调用trackRevenue函数，自动记录收入事件以及事件属性；price(商品价格)、productID(商品ID)、productQuantity(商品数量)、revenueType(收入类型)为收入事件内置属性，必传项。

具体使用方法如下：

App.zhuge.trackRevenue({
  'price': 2000,
  'productID': '小米NFC手环',
  'productQuantity': 2,
  'revenueType': '手环'
});