$ npm i @wise-group/tracking-jssdk
// 在入口文件
// 小程序原生开发 app.js
const wTracker = require('@wise-group/tracking-jssdk')
// 第三方框架,如uniapp
// src/main.js
import wTracker from "@wise-group/tracking-jssdk";
// app.js
const wTracker = require('@wise-group/tracking-jssdk')
wTracker.init({
apiUrl: 'xxx'
})
// 针对小程序端,需要将apiUrl的域名加入小程序的Request合法域名中
App({
...
})
// src/main.js
...
wTracker.init({
apiUrl: 'xxx',
framework: {
uni: Vue
}
})
...
// src/main.js
export function createApp() {
...
// const app = xxxx;
wTracker.init({
apiUrl: 'xxx',
framework: {
uni: app
}
});
// return xxxx
...
}
初始化SDK
字段 | 必填 | 类型 | 默认值 | 说明 |
---|---|---|---|---|
apiUrl | Y | string | null | 服务端接口域名 针对小程序端,需要将apiUrl的域名加入小程序的Request合法域名中 |
appId | N | string | - | 小程序AppId |
agentId | N | string | - | 企微应用 agentid |
debug | N | boolean | false | debug模式 |
platform | N | string | - | 当前平台,默认系统会自动判断 如有特殊情况可手动指定平台; 可选值: mp-wx | web
|
manual | N | boolean | false | 是否全手动提交 默认为 false ,sdk会自动上报程序和页面级的进入 离开 行为 |
framework | N | Object | - | 框架信息 |
framework.uni | N | - | uni实例(如果使用uni app框架则必填,否则无法自动抓取页面访问行为) 使用方法 |
事件上报
字段 | 必填 | 类型 | 说明 |
---|---|---|---|
action | Y | string | 上报行为: launch: 应用启动 enter: 进入页面 leave: 离开页面 click: 点击 ${actionName}: 自定义行为名称 |
param | N | object | 附加参数,格式 {key: value} |
eventCode | N | string | eventCode |
追加字段
部分字段在初始化时无法获取,例如用户的unionId,因此加入数据插入机制,在获取后进行补偿插入
字段 | 必填 | 类型 | 说明 |
---|---|---|---|
unionId | N | string | 用户uid |
openId | N | string | 用户oid |
agentId | N | string | 企微应用 agentid |
wechatWorkUserId | N | string | 企微用户id |
wechatWorkEUserId | N | string | 企微外部联系人id |