What's this ???

一个用于微信小程序的自定义数据打点工具库，并提供了如下特性：

• 多个数据点的合并发送，并且可自定义每个请求最小/最多的数据包的量
• 支持自定义网络请求方法的注入
• 友好的重试机制
• 请求顺序发出
• 支持通过yarn/npm引入Ts、js或者复制粘贴引入
• 可采用默认基座数据/无基座数据

另外，此工具 默认不开启 侵入性的通过劫持重写Page中onShow方法的pv自动打点。但可以手动开启（需要在App onLaunch之前调用）

How To Use

• yarn 引入

  yarn add weapp-tracker

• npm 引入

  npm i weapp-tracker --save

• 手动复制粘贴

  复制dist/weapp-tracker.js文件到小程序开发目录

Documentation

此工具提供两个打点工具类，分别为BxTracker和Tracker，区别如下

• BxTracker提供默认基座，如wx.getSystemInfo中的内容以及网络类型，数据格式兼容神策小程序SDK。且在系统信息获取完毕之前阻塞所有数据点的打出，直到数据准备完毕
• Tracker默认只带有distinct_id一个字段

使用

• 初始化

  在小程序App.onLaunch之前调用

  // es2015
  import { BxTracker } from 'weapp-tracker';
  // CommonJs
  const BxTracker = require("weapp-tracker").BxTracker;
    
  BxTracker.configure(config);
  BxTracker.sharedInstance().setGlobalProperties(globalData);
    
  // 如需劫持page.onShow方法实现自动记录pv，则调用如下方法
  BxTracker.sharedInstance().enableAutoPageViewEvent(page => {
      return {
          message: '',
          detail: {},
      }
  });

  其中，config格式如下

  interface TrackerConfig {
    // 服务器地址
    serverURL: string
    
    // track有多少条之后会上传, 默认为10
    patchCount?: number
    
    // 每个请求最多的track条数, 默认为50
    maxNumberOfTrackInRequest?: number
    
    // 自定义的request方法, 默认为wx.request
    customRequest?: CustomRequest
    
    // 用户已经标示的ID
    distinctID?: string
    
    // 两次请求间隔(第一个请求结束到第二个请求开始)时间, 单位毫秒, 默认为1秒
    requestInterval?: number
    
    // 开启base64编码, 默认不开启
    enableBase64Encode?: boolean
  }

  globalData可以为一个Object，或者一个返回Object的闭包

• 使用

  // es2015
  import { BxTracker } from 'weapp-tracker';
  // CommonJs
  const BxTracker = require("weapp-tracker").BxTracker;
    
  BxTracker.sharedInstance().trackMessage('message', {
        ...detail
  });

This is a total piece of SHIT !!!

您先试试提个issue过来让我试着改改？

OS：不我觉得这个傻x作者肯定改不好/我等不及/我知道哪里错了我马上就能改好

您不妨自己fork下来改一下……？流程如下：

• fork project

• git clone your git web url

• cd BxTracker-weapp

• yarn install

• 对着src里面的ts文件就是一通骚操作

• yarn build

• git commit -m ~~原作者是个傻x，我在帮他擦屁股~~

• git push ~~--force~~

• 看一下自己的引用方式

  • 使用npm/yarn等包管理器？

    • 把你自己项目引用的weapp-trakcer地址指向自己的git链接，并运行包管理器的更新指令

  • 直接复制粘贴了dist/weapp-tracker.js文件？

    • 把新生成的dist/weapp-tracker.js文件替换掉原来文件

• 然后劳烦您不妨给我顺便提个pr？感激不尽