0.0.4 • Published 2 years ago

mql-web-report v0.0.4

Weekly downloads
-
License
ISC
Repository
-
Last release
2 years ago

koznak-report

大数据上报

安装

npm i mql-web-report -S

示例 🌰

import ReportSdk from "mql-web-report";
const reportSdk = ReportSdk.getReportSdk("appKey", {
  userId: "",
  version: "",
  tocken: "",
  deviceId: "",
  carrier: "",
});
// 心跳事件
reportSdk.reportHeart();
// 浏览事件
reportSdk.reportPage({
  pageId: "",
  pageName: "",
  eventId: "",
  eventType: "",
});

参数

字段说明类型是否必穿、默认值
appKey大数据唯一标识string
userInfo用户信息UserInfo
env环境"test | "product"可为空、默认"test"测试环境

UserInfo

字段说明类型
userId唯一标识string
tocken登陆令牌string
version版本号string
deviceId设备IDstring
carrier运营商"Mobile" | "Unicom" | "Telecom" |""

方法

reportHeart 🔧

心跳事件

代码演示

import ReportSdk from "mql-web-report";
const reportSdk = ReportSdk.getReportSdk("appKey", {
  userId: "",
  version: "",
  tocken: "",
  deviceId: "",
  carrier: "",
});
reportSdk.reportHeart();

返回类型

Promise<void>

reportPage 🔧

浏览事件

代码演示

import ReportSdk from "mql-web-report";
const reportSdk = ReportSdk.getReportSdk("appKey", {
  userId: "",
  version: "",
  tocken: "",
  deviceId: "",
  carrier: "",
});
reportSdk.reportPage({
  pageId: "",
  pageName: "",
  eventId: "",
  eventType: "",
});

参数说明

ReportPageP
字段说明类型是否比传
pageId页面IDstring
pageName页面名称string
eventId事件IDstring
eventType事件类型string
dataMap自定义数据{[key:string]:any}

返回类型

Promise<void>

reportClick 🔧

点击事件

代码演示

import ReportSdk from "mql-web-report";
const reportSdk = ReportSdk.getReportSdk("appKey", {
  userId: "",
  version: "",
  tocken: "",
  deviceId: "",
  carrier: "",
});
reportSdk.reportClick({
  pageId,
  targetId,
  targetName,
  targetType,
  eventId,
  eventType,
});

参数说明

ReportClickP
字段说明类型是否比传
pageId页面IDstring
pageName页面名称string
eventId事件IDstring
eventType事件类型string
targetType目标类型string
targetName目标类型string
dataMap自定义数据{[key:string]:any}

返回类型

Promise<void>

reportExposure 🔧

曝光事件

代码演示

import ReportSdk from "mql-web-report";
const reportSdk = ReportSdk.getReportSdk("appKey", {
  userId: "",
  version: "",
  tocken: "",
  deviceId: "",
  carrier: "",
});
reportSdk.reportExposure({
  pageId,
  targetId,
  targetName,
  targetType,
  eventId,
  eventType,
});

参数说明

ReportExposureP
字段说明类型是否比传
pageId页面IDstring
pageName页面名称string
eventId事件IDstring
eventType事件类型string
targetType目标类型string
targetName目标类型string
dataMap自定义数据{[key:string]:any}

返回类型

Promise<void>

类型定义

import type {
  Sdk,
  Env,
  ReportClickP,
  ReportExposureP,
  ReportPageP,
  DataMap,
  Target,
  Event,
  Page,
  UserInfo,
} from "mql-web-report";

开发说明

目录结构

src

开发目录

文件名说明
config.ts配置文件
index.ts入口
reportSdk.ts大数据上报类
tools.ts工具库
type.ts类型集合

tests

测试目录

文件名说明
mock模拟上报数据
unit测试用例
wswebSocket监听上报结果

.husky

Git钩子相关

dist

打包文件

脚本说明

  • lint

ESlint代码语法校验、prettier代码格式校验并尝试自动修复

  • tsc

TypeScript类型校验

  • lint:commit

lint校验Git暂存区

  • patch

npm包版本升级

  • test

运行jest测试用例

  • build

打包

  • commit

git cz代码提交(用于commit信息约束)

  • 其他

CI、publish脚本用于CI发版、prepare用户Git钩子初始化

0.0.4

2 years ago

0.0.3

2 years ago

0.0.2

2 years ago

0.0.1

2 years ago