@hyext/hyext-reporter-ya v1.2.3

小程序统一日志上报

• @hyext/hyext-reporter-ya
• 负责统一小程序日志数据
• 主要用于搭载了YA 上报 小程序 H5 产品
• 需要传入小程序相关端基础信息 CommonInfo
• 提供全局心跳，默认 30 秒心跳一次
• 日志延迟 500ms 上报，每次上报最多 100 条；

安装

npm install @hyext/hyext-reporter-ya

引入

import { YAExtReporter, LogEvents } from '@hyext/hyext-reporter-ya'

初始化 - new YAExtReporter(config)

配置 config

CommonInfo

• 日志公共数据，每条日志的基础信息，可覆盖

env

• 环境信息

示例

• 先通过平台获取基础数据

const basInfo = {
  ext_id: "abababa", // 小程序ID
  uid: "202020", // 用户uid
  pid: "202011", // 主播ID
  game_id: "1002", // 品类ID
  env: "online"
}

• 实例化

const extReporter = new YAExtReporter({
  Debug: true,
  OpenReport: true,
  CommonInfo: {
    uid: basInfo.uid,
    pid: basInfo.pid,
    ext_id: basInfo.ext_id,
    game_id: basInfo.game_id
    env: basInfo.env
  },
  YAInstance: window.ya
});

开始心跳 - extReporter.startHeartBeat(fields);

• 只有一个全局的心跳
• 默认 30s 一次心跳
• 心跳用于统计用户在线时长，用户进入即开始心跳即可

参数

示例

extReporter.startHeartBeat();

停止心跳 - extReporter.endHeartBeat()

• 停止全局的心跳
• 用户退出时调用

示例

extReporter.endHeartBeat();

普通上报 - extReporter.reportBusiMetric(info, fields)

参数

info

• 日志描述信息，不会被 fields 覆盖
• 系统预制了一些日志描述信息 LogEvents 方便使用
• 也可定义自己日志描述信息

LogEvents

• 预制日志描述信息
• 均为与 info 同构变量
• 按需上报即可

fields

• 自定义上报数据
• 键值不能与以下取值重复，否则会被覆盖

示例

• 自定义上报

extReporter.reportBusiMetric({
  key: 'ext_diy/my_action'
  desc: '自定义事件描述'
}, {
  data : 'your_data'
});

• 上报用户交互

extReporter.reportBusiMetric(LogEvents.USER_ACTIVE, {
  act: '啥交互？'
});

• 上报用户送礼

extReporter.reportBusiMetric(LogEvents.USER_SEND_GIFT, {
  gift_id: 2222,
  gift_count: 1,
  gift_amount: 100
});

• 上报用户发言

extReporter.reportBusiMetric(LogEvents.USER_SEND_WORD, {
  word: '你说啥？'
});

• 上报订阅主播

extReporter.reportBusiMetric(LogEvents.USER_SUBSCRIBE);

• 上报用户分享

extReporter.reportBusiMetric(LogEvents.USER_SHARE, {
  share_type: 1
});

• 上报开始游戏

extReporter.reportBusiMetric(LogEvents.GAME_CREATE);

• 上报游戏结束

extReporter.reportBusiMetric(LogEvents.GAME_FINISH);