tzgo

埋点文件生成工具

安装

npm i -g tzgo

生成配置文件 trackConfig.json

track -i

生成埋点文件

track

默认在当前目录下生成track文件夹

埋点方法

import Track from '@/track/index';
import { handleFiboPageTrack } from 'track/generate/track';

// 必须先初始化再触发埋点
//埋点初始化
Track.init(userInfo);

//普通埋点
Track.report('加载页pvuv');

//单个编码
Track.report('加载页pvuv-编码N', '编码N', '确定');

//多个编码
Track.report('加载页pvuv-编码N-编码M', [
  ['编码N', '确定'],
  ['编码M', '取消']
]);

// 处理斐波翻页埋点，斐波初始化后调用一次即可
pageAndDurationTrack({
  routes: [], // 必传，需要触发埋点的路由，如：['/', '/About', '/Landing']
  query: {}, // 选传，具体看需求，通常传入当前链接上的参数即可，使用 rpf/un/
  itemId: '活动号' //apg环境必传
});

配置文件

• 支持一个 excel 多个 sheet
• 多个 sheet 时注意修改输出的文件名，否则会覆盖原来的映射文件名
• 只会生成一个 track.js 文件，多次执行 track 指令不会覆盖原 track.js

// trackConfig.json
{
  "xlsxPath": "track.xlsx", // 埋点表格路径
  "outPath": "", // 生成文件的目录,默认为track
  "outType":"ts" //生成的文件类型，默认为ts，可选js
  "sheets": [
    {
      "sheetName": "埋点表", // 需要输出的sheet名
      "outputName": "index.js", // 输出的映射文件名，不带.js后缀会自动补全
      "excludeKey": [] // 埋点表格中要忽略的健,如 'PA__is_web'
    }
  ]
}

生成文件例子 ,见 example文件夹

生成的数据示例

/** 每日任务-邀请好友【去完成】按钮 */
  '每日任务-邀请好友【去完成】按钮': {
    Fibo__btn_name: '每日任务-邀请好友【去完成】按钮',
    Fibo__btn_id: 'btn-home-todo5',
    PA__event_id: '112211443',
    PA__label_id: '4990120-20201029559129',
    PA__is_web: '内部',
    Beacon__evt: 'todo5',
    Beacon__page_id: 'H5web_shouxian_activity_transfer_page ',
    Beacon__event_desc: 'flu',
    Beacon__channel: 'shouxian'
  },

其他

• 生成的track.js文件，定义了菲薄和 apg 的埋点方法，可以再后面添加其他埋点方法，如好医生；
• 检查项目中是否包含了埋点语句,track-check vs-code 插件