---

order: 1 title: 移动端埋点

@firesoon/mobile-track

移动端统一的埋点数据自动采集方案，支持 H5、原生小程序、以及 Taro 生成的小程序的埋点数据采集。

安装

yarn add @firesoon/mobile-track

配置

H5需要如下配置：

const config = {
    ...
    h5: {
        ...
        resolve: {
            mainFields: ["main:h5"]
        }
    }
}

使用

• app.tsx文件

// 引入
import track from '@firesoon/mobile-track';
import trackFun from '@/service.ts';

/**
 * 初始化
 * trackFun:为业务埋点请求方法
 */
track.init(trackFun);

init方法参数trackFun为埋点数据发送方法，需要开发人员传入。

• service.ts文件

import Taro from '@tarojs/taro';

//仅为示例，并非真实的接口地址
export const trackFun = (params) => {
    Taro.request({
        url: '/track.action', 
        data: {
            ...params
            systemName: '商保通小程序',// 系统名称
            appVersion: '1.0.0',// 应用版本
            userId: '',// 用户ID
            userName: '',// 用户名称
            orgName: '',// 机构名称
            orgCode: '',// 机构代码
        },
        success: function (res) {
            console.log(res.data)
        }
    })
}

• 代码埋点标识：
  • 1、Button组件会自动采集，需要添加data-log-name="按钮点击"；
  • 2、对于其他标签，需添加auto-track样式选择器，同时添加data-log-name="按钮点击"；
  • 3、支持 data-log-module 采集

参数说明

trackFun方法传入埋点插件后，埋点插件会收集一部分埋点数据，主要包括一下数据：

• 当前菜单code: menuNo,
• 当前菜单名称: menuName
• 上一个菜单code: menuPrev
• 上一个菜单名称: menuPrevName
• 触发时间: stamp
• 可视化大小: size
• 用户代理（浏览器版本、系统版本）: userAgent
• 用户IP(小程序支持): ip
• 埋点版本: logVersion
• 事件类型（openPage、closePage，touchstart）: eventType
• 记录功能的字段: value
• 节点名称: tagName
• 页面模块信息: modules
• 停留时间：duration
• 网络类型： networkType

其中部分参数需要应用提供，包括以下参数：

• 系统名称: systemName
• 用户ID: userId
• 用户名称: userName
• 机构名称: orgCode
• 机构代码: orgName
• 应用版本（与产品版本一致）: appVersion