uni-stat-v2.md 53.0 KB
Newer Older
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
1
uni统计2.0 是开源、全端、云端一体、更适合uni-app的统计平台。
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
2

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
3
> `HBuilderX 3.4.10 +`起支持
F
fasttian 已提交
4

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
5 6 7 8 9 10
## demo体验

体验系统:[https://hellouniadmin.dcloud.net.cn/](https://hellouniadmin.dcloud.net.cn/)

注:uni统计内置在[uni-admin](/uniCloud/admin)中,体验系统的数据会定期重置。

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
11 12
![](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/28ddae77-dda6-448f-86aa-7e59bb7c4f8d.png)

F
fasttian 已提交
13 14
## 产品特色

hbcui1984's avatar
hbcui1984 已提交
15
无需开发,在`manifest``uni统计` 中打勾并发行,在[uniCloud](/uniCloud/)服务空间部署[uni-admin](/uniCloud/admin),即可查看报表。
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
16 17

同时开发者也可以自定义打点数据、自定义展现报表。
F
fasttian 已提交
18 19


DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
20
**1. 全端**
F
fasttian 已提交
21

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
22
全端流量统计,一张报表可查看所有端(iOS、Android、Web 及各家小程序)的运营数据。
F
fasttian 已提交
23

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
24
无需在各端接不同的sdk、无需在不同报表看数据。目前市面已知唯一一个一张报表看遍业务全景的方案。
F
fasttian 已提交
25

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
26
**2. 开源、免费、自由定制**
F
fasttian 已提交
27

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
28
无论前端采集数据的SDK、云端接收数据的云函数、云端跑批统计的云函数、展示统计结果的报表,所有这些代码全部开源。
F
fasttian 已提交
29

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
30
前端自定义打点,后端自定义统计维度,自由定制报表,一切都可以灵活定制。
F
fasttian 已提交
31

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
32 33
**3. 私有部署、数据自控**

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
34 35
使用传统saas类统计产品,所有数据都上报给统计服务厂商。

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
36 37 38 39 40 41 42 43 44 45
`uni统计2.0`基于`uniCloud`实现,云函数、统计数据全部托管在开发者自己的服务空间(阿里云或腾讯云自选)中,开发者对自己的统计数据拥有完整的控制权。

**4. 默认功能丰富**

- 设备统计
- 注册用户统计(基于[uni-id](https://uniapp.dcloud.io/uniCloud/uni-id.html)
- 页面统计
- 新增、活跃、留存、跳出率分析
- 渠道分析:辅助渠道推广
- 错误统计和上报:辅助产品质量提升
hbcui1984's avatar
hbcui1984 已提交
46
- 原生App崩溃统计,分版本查看崩溃率
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
47 48 49 50 51 52 53 54 55 56 57 58
- 自定义打点、开源可扩展的报表

**5. 有效的错误分析**

传统统计平台,都没有js错误统计。开发者无法了解到自己的js代码在哪些设备上会报错。

uni统计的错误信息更全面,包括 js前端错误和 App 原生层的崩溃。辅助开发者把应用做的更好。

**6. 更适合uni-app和uniCloud**

uni统计深入uni-app和uniCloud框架底层,提供了众多其他统计平台无法提供的功能:
- uni-app全端识别,无需对接不同sdk、无需在不同报表中切换和自己累加数据
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
59
- 自动识别uni-app路由,自动采集页面标题(基于pages.json的navigationBar或uni-nav-bar组件)
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
60 61 62
- 自动捕获js错误,上报app端原生崩溃日志
- 兼容uni-app渠道包打包体系,自动识别渠道包
- 基于uni-id账户体系,自动出具注册用户(不是设备)的新增、活跃、留存报表
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
63
- 兼容uniCloud [opendb规范](/uniCloud/opendb),从服务器端统计各项数据
F
fasttian 已提交
64

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
65
**7. 开放生态**
F
fasttian 已提交
66

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
67
uni统计的开源且基于[uni-admin](/uniCloud/admin)的插件规范提供了插件机制,会有更多插件作者提供各种丰富的统计插件(如电商统计、内容统计等)。见[插件市场](https://ext.dcloud.net.cn/?cat1=7&cat2=74&type=HotList)
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
68

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
69 70 71 72 73
**DCloud非常重视数据驱动开发者业务的增长,近期联合专业的大数据服务商<a href="https://www.sensorsdata.cn/" target="_blank">神策</a><a href="https://tj.aldwx.com/" target="_blank">阿拉丁</a>共同完善Uni统计2.0的产品模块和生态建设。
如果你对数据分析有任何需求,欢迎您填写<a href="https://sdmarketing.wjx.cn/vj/h2UFHnx.aspx" target="_blank">需求调研问卷</a>,我们会根据您的宝贵建议,在原有Uni统计产品的基础上,完成迭代更新。**


## uni 统计老版升级建议
F
fasttian 已提交
74

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
75
对于使用uni统计1.0的开发者,推荐尽快升级到uni统计2.0。uni统计1.0将不再更新维护。
F
fasttian 已提交
76 77 78 79 80

|功能|uni统计1.0|uni统计2.0|
| :-: | :-: | :-: |
|是否开源 |否|是|
|部署方式 |中央部署|私有部署|
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
81 82 83
|定制方式 |不可定制|自由定制|
|uni-id用户统计 |不含|默认包含|
|错误分析有效性|较低|较高|
F
fasttian 已提交
84

L
linju-json 已提交
85

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
86 87 88 89 90
## 环境要求
- uni统计2.0 在客户端仅支持uni-app,非uni-app无法使用。
- uni统计2.0 在云端虽然依赖uniCloud,但并不要求开发者的应用全部基于uniCloud开发。应用的主业务可以连接传统服务器,统计打点、报表展现使用uniCloud即可。


F
fasttian 已提交
91 92 93
## 使用教程

`uni统计2.0`包括两个模块:
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
94 95
- 前端采集模块:内置在`uni-app`框架中,在业务App的`manifest.json`进行配置;
- 云端统计模块:内置在`uni-admin`项目模板中,和业务App复用同样的uniCloud服务空间;
F
fasttian 已提交
96 97 98

### 前端采集配置

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
99
在业务App项目的 `manifest.json` 里,选择 `uni统计配置` 项,根据需求,选择开通 `uni统计` ,勾选 `2.0` 开启新版统计。
F
fasttian 已提交
100

M
mehaotian 已提交
101
![开启统计](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/14b2b045-3d8e-4535-acad-2e745441c816.png)
F
fasttian 已提交
102

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
103
上述可视化操作,其实对应manifest源码视图的 `uniStatistics` 节点。如下文档对manifest规范进行详述。**如不关心规范细节,可以不阅读本小节,继续看下一节《小程序域名白名单》**
F
fasttian 已提交
104

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
105
`uniStatistics` 下的 `enable` 字段设置为 `true|false`,来开启关闭 `uni统计`
F
fasttian 已提交
106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125

设置 `version` 属性为 `"2"` 来开启新版统计

```js
//...
"uniStatistics": {
	"enable": true,//全局开启
	"version": "2" // 开启新版uni统计,值为字符串
},
//...
```

**uniStatistics说明**

|字段|类型|默认值|可选值|说明|
|:-:|:-:|:-:|:-:|:-:|
|enable|Boolean|false|true , false|全局开启或关闭统计 ,分平台配置会覆盖当前配置|
|version|String|"1"|"1" , "2"|统计版本 ,如不填写,默认使用版本1.0,推荐使用2.0版本|
|debug|Boolean|false|true , false|开启统计调试模式 ,会产生大量日志,且会在开发阶段上报数据,应用发布请关闭此项|

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
126
`uniStatistics` 支持分平台设置,比如仅开启微信小程序平台的 `uni统计`,则在`mp-weixin`节点下设置 `uniStatistics ->enable` 即可,如下:
F
fasttian 已提交
127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144

```js
//...
"mp-weixin":{
    "uniStatistics": {
        "enable": true //微信平台开启统计
    }
}
```

**uniStatistics说明**

|字段|类型|默认值|可选值|说明|
|:-:|:-:|:-:|:-:|:-:|
|enable|Boolean|false|true , false|分平台开启或关闭统计 ,分平台配置会覆盖全局配置,uniStatistics 需在平台配置下|

::: warning 注意
- 在分平台下如有`uniStatistics -> enable`字段,则优先使用分平台下配置 ,反之使用全局统计设置
M
mehaotian 已提交
145 146
- 分平台无需设置 `version``debug` 属性 ,两个属性仅全局生效
- 分平台无需设置 `debug` 属性 ,该属性仅在全局生效
F
fasttian 已提交
147
- 仅在开启调试模式或发行代码后才会正常上报数据
L
linju-json 已提交
148 149 150
:::


DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
151
#### 小程序域名白名单
F
fasttian 已提交
152

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
153
由于各家小程序对可访问的域名要配置白名单,否则无法联网。所以需要发布小程序时需要在各厂商的小程序管理后台配置域名白名单。
F
fasttian 已提交
154

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
155
部署uni统计时可以选择使用uniCloud的阿里云版或腾讯云版,不同云厂商对应的域名不同(文章后面章节会有服务空间相关配置)
F
fasttian 已提交
156

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
157
| uniCloud服务提供商 |      request 合法域名       |
F
fasttian 已提交
158 159 160 161
| :--------: | :-------------------------: |
|   阿里云   |       api.bspapp.com        |
|   腾讯云   | tcb-api.tencentcloudapi.com |

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
162
根据选择的uniCloud云厂商,配置相应的域名到小程序的域名白名单配置里即可。
F
fasttian 已提交
163 164 165

#### 调试模式

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
166
`manifest.json -> uniStatistics` 下的 `debug` 字段设置为 `true|false` ,来开启关闭 `uni统计`调试模式
F
fasttian 已提交
167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208

在调试模式下,会将上报数据的关键信息打印到控制台,方便观察采集信息是否正确 ,多用在自定义扩展的时候

**日志格式**

`===` 表示统计日志相关日志

``` js
// 标识统计开启
=== uni统计开启,version:2.0

// 采集日志,采集类型见 :上报数据说明
=== 统计数据采集{采集类型} ===
// 这里是采集的原始数据
{
	fvts: 1647313662
	lang: "zh"
	lt: "1"
	lvts: 1650857441
	md: "PC"
	t: 1650857461
	ttpj: "view"
	tvc: 14
	url: "pages/component/view/view"
	usv: "0.0.1"
	ut: "h5"
	// ...
} 
=== 采集结束 ===

// 数据上报成功
=== 统计队列数据上报 ===
// 这里是上报数据
{usv: '0.0.1', t: 1650857765, requests: '["lt=11&ut=h5&url=/pages/component/view/view&tt=&u…&ch=&usv=0.0.1&t=1650857765&ttn=&ttpj=view&ttc="]'}
=== 上报结束 ===

```

日志字段说明,详见[前端采集SDK](#web-sdk)

### 后台报表配置

hbcui1984's avatar
hbcui1984 已提交
209
#### 创建 admin 项目
F
fasttian 已提交
210

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
211 212 213
`uni统计2.0`的后台统计报表是[uni-admin](https://uniapp.dcloud.io/uniCloud/admin.html)的内置插件。

[uni-admin](https://uniapp.dcloud.io/uniCloud/admin.html)是一个开源管理后台。也就是使用`uni统计2.0`,需要安装这个后台系统,在里面找到uni统计的菜单并使用。
F
fasttian 已提交
214 215 216

请参考[uni-admin](https://uniapp.dcloud.io/uniCloud/admin.html#uni-admin-%E6%A1%86%E6%9E%B6-%E5%8E%9F%E5%90%8D-unicloud-admin)文档,完成如下操作:

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
217 218 219
1. 创建新的`uni-admin`项目(HBuilderX新建项目界面选择uni-admin模板)
2. 在弹出的云服务空间初始化向导中,关联服务空间(如果您的业务App已使用了uniCloud,那么选择相同的服务空间;否则,新建一个服务空间,并在业务App里关联相同服务空间)
3. 部署云端资源:上传部署云函数、公共模块、通过`db_init.json`初始化数据库表。如之前的表已经有冲突数据,需要自己手动合并下
hbcui1984's avatar
hbcui1984 已提交
220
4. 在云端配置中心完成其它初始化配置,如:在 `uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json` 文件中填写自己的 passwordSecret 字段 (用于加密密码入库的密钥) 和 tokenSecret 字段 (为生成 token 需要的密钥,测试期间跳过本条也可以),然后对`uni-config-center`公共模块点右键上传更新。注意:`业务端App项目``报表端uni-admin项目`关联相同服务空间时,可能会出现`uni-config-center`的相互覆盖问题,此时建议单点维护,[详见](https://uniapp.dcloud.net.cn/uni-stat-v2.html#常见问题)
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
221 222 223 224 225
5. 运行 uni-admin 项目,一般是运行到浏览器
6. 设置管理员账户
7. 在左侧「应用管理」中新增「被统计应用」的记录(appid 等)
8. 配置结束后,启动业务App,将会在运行后的`uni-admin`页面左侧的uni统计菜单里看到业务App的数据(如看不到数据,见下方常见问题章节)
9. 测试通过后,在HBuilder发行菜单里发行`uni-admin`项目,选择部署到uniCloud服务空间的前端网页托管里。可以在[uniCloud web控制台](https://unicloud.dcloud.net.cn/)自定义域名。
L
linju-json 已提交
226

F
fasttian 已提交
227

F
fasttian 已提交
228
::: warning 注意
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
229
- 「连接本地云函数」运行需要在 uni-admin 的 database 文件夹上右键,点击「下载所有DB schema及扩展校验函数」。如果之前服务空间初始化向导里漏操作了`db_init`初始化数据,则对`uniCloud/database/db_init.json`点右键初始化
L
linju-json 已提交
230 231 232
:::


DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
233 234 235 236 237 238 239 240 241 242 243
**uni-admin老项目升级**

如您需要统计的业务之前已经使用了`uni-admin`,可以升级`uni-admin`。对项目下的`package.json`点右键,选择「从插件市场更新」。

uni统计新增的文件主要包括:
- 云函数:`uniCloud/cloudfunctions/uni-stat-cron`(定时跑批云函数)、`uniCloud/cloudfunctions/uni-stat-receiver`(接收前端打点的云对象)
- 云函数公共模块:`uniCloud/cloudfunctions/common/uni-stat`
- 数据表:`uniCloud/database`目录下`uni-stat`开头的若干`schema`文件
- 统计页面:`pages/uni-stat` 文件夹下面的若干页面

更新时注意合并pages.json,确保新页面都注册成功。否则运行起来后,点击左侧菜单会报找不到xxx文件。
hbcui1984's avatar
hbcui1984 已提交
244

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
245 246 247
`db_init.json`初始化数据库时,老项目的菜单表`opendb-admin-menus`,已经有数据了,此时key冲突的数据无法插入,需要手工合并。
1. 如果老项目没有改动过menus和权限,那么可以删掉老表,重新初始化
2. 如果老项目的menus菜单改动过,需要把uni统计的若干页面再合并到菜单数据表里
F
fasttian 已提交
248

JiaRongPing's avatar
JiaRongPing 已提交
249
#### 设置定时任务云函数的触发周期
F
fasttian 已提交
250

JiaRongPing's avatar
JiaRongPing 已提交
251
`uni统计2.0``定时任务云函数(uni-stat-cron)`的默认触发周期为每小时触发一次(即:每隔1小时,系统会自动触发一次`uni-stat-cron`云函数)。
F
fasttian 已提交
252

JiaRongPing's avatar
JiaRongPing 已提交
253
你可以根据需要修改`定时任务云函数(uni-stat-cron)`的触发周期到分钟级(即每隔n分钟触发一次),但要注意触发周期修改后,需要确保[定时任务配置项](#定时任务配置说明)中设置的分钟数是否会被触发,比如你的配置项中设置的是每小时的第10分钟触发(表达式:`* * * 10`),而定时触发器设置的为每20分钟触发1次(`0 1/20 * * * * *`),那这个配置项将永远不会触发。
F
fasttian 已提交
254 255

::: warning 注意
JiaRongPing's avatar
JiaRongPing 已提交
256 257
1. 现阶段阿里云仅支持小时级的定时任务(即阿里云云函数的定时触发的最小间隔只能设置为每小时触发一次),因此现阶段阿里云用户如想将`定时任务云函数(uni-stat-cron)`的触发周期设置为分钟级须先向DCloud申请后再开启。[申请方式](https://uniapp.dcloud.io/uniCloud/price.html#aliyun)
2. 因云函数单次最大运行时长为10分钟,所以开启分钟级定时任务后,如果想重新设置定时任务中触发时间的话,最好确保各定时任务之间的触发间隔时间要大于等于10分钟,防止出现运行超时的问题。默认定时任务类型和触发时间可参考下方[定时任务配置说明](#定时任务配置说明)的说明。
F
fasttian 已提交
258 259 260 261
:::

- 我们这里以将跑批周期修改为每隔10分钟触发1次为例,正确的步骤为:

JiaRongPing's avatar
JiaRongPing 已提交
262
1. 修改[uni统计配置项](#公共模块配置项说明)`cronMin`参数的值改为`true`
F
fasttian 已提交
263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281
2. 修改`定时任务云函数(uni-stat-cron)`下的`package.json`文件中的定时触发器配置项,关于定时触发器的具体说明可以参考官方文档[定时触发器](https://uniapp.dcloud.io/uniCloud/trigger.html)
``` javascript
"cloudfunction-config": {
	"concurrency": 1,
	"memorySize": 256,
	"timeout": 600,
	"triggers": [
		{
			"name": "uni-stat-cron",
			"type": "timer",
			"config": "0 1/10 * * * * *"//每隔10分钟触发1次的cron表达式,如需复制此项请务必删除该注释
		}
	]
}
```
3. 检查配置文件(`config.json`)中的`cron`参数中设置的选项是否会被触发。
4. 重新上传部署`定时任务云函数(uni-stat-cron)``配置中心(uni-config-center)`


hbcui1984's avatar
hbcui1984 已提交
282
#### 开启redis缓存
F
fasttian 已提交
283

M
mehaotian 已提交
284 285
开启redis缓存后可以降低数据库查询压力,提升uni统计性能,可按需决定是否开启。

hbcui1984's avatar
hbcui1984 已提交
286 287 288 289 290
::: warning 注意
开启redis缓存前,需要先确认是否已在布署uni统计的服务空间内购买redis服务,如果没有购买则需要先购买redis服务。
:::

**开启步骤:**
JiaRongPing's avatar
JiaRongPing 已提交
291
1. 修改[uni统计配置项](#公共模块配置项说明)`redis`参数的值改为`true`
hbcui1984's avatar
hbcui1984 已提交
292 293
2. 分别在数据`上报数据接收器(uni-stat-receiver)``定时任务云函数(uni-stat-cron)`下的`package.json`文件中添加redis拓展库。
3. 重新上传部署数据`上报数据接收器(uni-stat-receiver)``定时任务云函数(uni-stat-cron)``配置中心(uni-config-center)`
F
fasttian 已提交
294 295

::: preview 
M
mehaotian 已提交
296
> 配置uni-stat-receiver的redis拓展库
hbcui1984's avatar
hbcui1984 已提交
297 298 299 300 301 302 303 304 305 306 307
``` javascript
{
	"name": "uni-stat-receiver",
	"dependencies": {
		"uni-id": "file:../../../../uni-id/uniCloud/cloudfunctions/common/uni-id",
		"uni-stat": "file:../common/uni-stat"
	},
	"extensions": {
		"uni-cloud-jql": {},
		"uni-cloud-redis": {} // 配置为此云函数开启redis扩展库,值为空对象留作后续追加参数,暂无内容。如拷贝此配置项到package.json文件,切记去除注释。
	}
F
fasttian 已提交
308
}
M
mehaotian 已提交
309
``` 
F
fasttian 已提交
310
> 配置uni-stat-cron的redis拓展库
hbcui1984's avatar
hbcui1984 已提交
311
``` javascript
F
fasttian 已提交
312 313 314 315 316 317 318 319 320 321 322 323
{
	"name": "uni-stat-cron",
	"version": "1.0.0",
	"description": "",
	"main": "index.js",
	"scripts": {
		"test": "echo \"Error: no test specified\" && exit 1"
	},
	"author": "",
	"license": "ISC",
	"dependencies": {
		"uni-stat": "file:../common/uni-stat"
hbcui1984's avatar
hbcui1984 已提交
324 325 326
	},
	"extensions": {
		"uni-cloud-redis": {} // 配置为此云函数开启redis扩展库,值为空对象留作后续追加参数,暂无内容。如拷贝此配置项到package.json文件,切记去除注释。
F
fasttian 已提交
327 328 329 330 331 332 333 334 335 336 337 338 339
	},
	"cloudfunction-config": {
		"concurrency": 1,
		"memorySize": 512,
		"timeout": 600,
		"triggers": [
			{
				"name": "uni-stat-cron",
				"type": "timer",
				"config": "0 0 * * * * *"
			}
		]
	}
hbcui1984's avatar
hbcui1984 已提交
340 341
}
```
M
mehaotian 已提交
342
:::
F
fasttian 已提交
343 344


hbcui1984's avatar
hbcui1984 已提交
345
### 关联服务空间
F
fasttian 已提交
346

hbcui1984's avatar
hbcui1984 已提交
347
为了让用户端App采集到的数据,可以被`uni-admin`中的云函数正确接收并统计,需保证用户端项目和admin项目,关联同样的服务空间。
F
fasttian 已提交
348 349 350 351 352 353 354 355 356 357

1. 选择用户端项目(需采集用户数据的项目)
2. 若该项目之前未启用`uniCloud`,右键并选择 `创建uniCloud云开发环境 -> 阿里云|腾讯云`;否则,进入第3步;

![关联前后台数据](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/b2ad84ed-a69a-43dc-b8d1-6efaafd96a14.png)

3.`uniCloud`目录右键并选择`关联云服务空间或项目`,在打开的窗口中选择对应`uni-admin`项目关联的服务空间

![关联前后台数据](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/14744bf3-c88e-4408-b2fa-0ecf0dcf4fe1.png)

D
DCloud_LXH 已提交
358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385
### 错误解析 <Badge text="uni-admin 1.9.4+" />@sourcemap-parse-error 

> 此功能只支持 web平台、App平台、微信小程序平台

为方便开发者使用 sourceMap 文件定位代码问题,增加在统计中使用 sourceMap 错误解析功能。

#### 使用环境

1. 使用腾讯云服务空间,不支持阿里云服务空间
2. HBuiderX 3.5.3+
3. uni-admin 1.9.4+
4. 不支持 IE

#### 生成 sourceMap@create-sourcemap

- 在 HBuiderX 中生成 sourceMap 文件
	- web 平台在`发行-> 网站`时,勾选 `生成 sourceMap` 选项。

		![web 平台生成 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/c9872cf7-39b1-4c00-9fe6-afc5939b3b31.jpg)
	- App 平台在`发行 -> 原生App-云打包`时,勾选 `生成 sourceMap` 选项。

		![app 平台生成 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/5366655c-0ba3-4f5a-b5fc-e80289ed1a17.jpg)
	- 微信小程序平台在`发行 -> 小程序-微信`时,勾选 `生成 sourceMap` 选项。

		![微信小程序平台生成 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/85c3eed9-e1b3-41c6-888f-bc1e2cb21a46.jpg)

- cli 项目生成 sourceMap 文件

D
DCloud_LXH 已提交
386 387 388 389 390 391 392 393 394 395
	::: preview

	> Vue2
	```sh
	yarn build:h5 --sourcemap

	yarn build:app-plus --sourcemap

	yarn build:mp-weixin --sourcemap
	```
D
DCloud_LXH 已提交
396

D
DCloud_LXH 已提交
397 398 399 400 401 402 403 404
	> Vue3

	```sh
	yarn build:h5 --sourcemap

	yarn build:app --sourcemap

	yarn build:mp-weixin --sourcemap
D
DCloud_LXH 已提交
405 406
		```

D
DCloud_LXH 已提交
407 408
	:::

D
DCloud_LXH 已提交
409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462
1. 项目编译完成后,可在 `/unpackage/dist/build/.sourcemap` 中查看到生成的各平台的 sourceMap 文件。

	![生成的 sourceMap 路径](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/52e1a71d-a6f2-4458-9213-186dd78684de.jpg)

3. 由于微信小程序平台上传发布后,会再压缩打包一次,所以需要额外一个步骤:
   1.[微信公众平台](https://mp.weixin.qq.com/)`开发管理/运维中心/错误日志`中下载线上版本 sourceMap 文件
   2. 将下载好的文件解压到所生成的 .sourcemap 文件夹中: `/unpackage/dist/build/.sourcemap/mp-weixin/__WEIXIN__/`(__WEIXIN__为新建的目录,解析错误时会根据这个名字查找)

   ![微信 download sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-a90b5f95-90ba-4d30-a6a7-cd4d057327db/2e4d0e4f-5be6-4a72-adf0-697a576dd3fa.png)

	**注意事项**

   1. 如果下载的 sourceMap 文件中,只有 `__FULL__` 文件夹,请重命名为 `__APP__`
   2. 只支持 `发行模式` sourceMap 文件错误解析

#### 上传 sourceMap@upload-sourcemap

1.`uni-admin 项目/pages/uni-stat/error/js/js.vue` 页面中做以下修改:
   1. 搜索 `cloudSpaceId` 补充腾讯云服务空间 SpaceID
   2. 搜索 `sourcemapBaseUrl` 补充腾讯云云存储访问地址(如:https://xx-xx-xx.tcb.qcloud.la/\_\_UNI\_\_/uni-stat/sourcemap)

	![cloudSpaceId](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/ffafa11c-ce74-425f-a4ef-f0900f44714c.jpg)

2. 将 uni-admin 项目运行到浏览器中,在 `uni 统计 / 错误统计 / js报错` 页面,错误信息列表表格的右上角有 `上传 sourceMap` 按钮。点击后展示如下:

	![上传 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-a90b5f95-90ba-4d30-a6a7-cd4d057327db/50878ced-c415-4d8d-923d-f3127e4a1add.png)

1. 上传请前请填写完整信息:`应用``平台``版本`
2. 点击 `选择文件并上传` 按钮,弹出 `选择文件夹` 框后,请选中编译的对应该平台版本的 sourceMap。如:**项目根目录/unpackage/dist/build/.sourcemap/h5**,选中 `h5` 目录后点击上传。如果中途上传失败,在不刷新页面的情况下,重新选择文件夹上传可以跳过已上传文件。
3. 文件夹内容会上传至 `云存储/__UNI__/uni-stat/sourcemap/应用 appId/平台(如:web、mp-weixin、ios)/版本/` 目录下

**注意事项**
1. 云存储需要配置权限:`所有用户可读`
2. 如果出现跨域需要在 `跨域配置` 中绑定安全域名
3. 上传失败可能会有如下原因:
   1. 如果文件名称、文件夹名称带 `ad` 或者广告类的字段,请关闭浏览器广告拦截扩展再上传
   2. 如果云存储中该目录已有同名文件,也可能会上传失败。所以在再次上传相同平台,相同版本的 sourceMap 文件前请将云存储中对应目录 (如:`云存储/__UNI__/uni-stat/sourcemap/应用 appId/平台(如:web、mp-weixin、ios)/版本/`) 删除

#### 解析错误@parse-error

`uni 统计 / 错误统计 / js报错` 页面,错误信息列表表格中,点击表格行中右侧 `详情按钮` 即可在弹窗中查看解析后错误信息。

**示例**

原始错误信息:

![原始错误:](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/1a8f0fcc-9bbf-4563-9c33-ebe4c7e14800.jpg)

解析后的错误信息:

![原始错误:](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/300b16e0-bfea-4dd5-ba95-e06dc1b75b51.jpg)

- 解析错误是逐行解析,某一行解析失败会返回原错误信息
- `runtime error` 分隔线下方为平台框架运行时错误栈信息,可以不用关心
F
fasttian 已提交
463 464 465 466 467 468 469

## 开源代码解读

- 前端采集SDK源码地址,[查看](https://github.com/dcloudio/uni-app/tree/next/packages/uni-stat)
- 云端统计模块以及统计后台源码地址,[查看](https://github.com/dcloudio/uni-admin)

### 前端采集SDK @web-sdk
M
mehaotian 已提交
470 471 472 473
#### 数据上报逻辑 @report-time

数据上报间隔最小是 10s 上报一次 ,在上报间隔内,会将每次上报节点的数据加入统计数据队列,10s后会在下一个上报节点,统一对数据队列进行一定的处理进行上报。

L
linju-json 已提交
474 475 476 477 478 479 480 481 482 483
这么做的目的是防止频繁上报引起的并发问题。所以上报请求不是时实发生的。

::: warning 什么时候会上报数据?

- 发行代码后,运行项目上报 `(HBuiderX -> 发行 -> 选择开通统计的平台)`
- 运行代码且开启调试模式上报 `(manifest.json -> uniStatistics -> debug:true)`

除了以上两种情况 ,其他情况都不会发生数据上报,包括 App 真机运行时(含自定义基座),崩溃和错误数据
:::

F
fasttian 已提交
484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612

#### 采集类型

**应用启动**

访问开始即启动程序,访问结束结分为:进入后台超过5min、在前台无任何操作超过30min、新的来源程序

|上报字段|说明|
|:-:|:-:|
|lt|统计数据类型,默认值为1,`类型见下文`|
|ut	|平台类型,`类型见下文`|
|mpsdk|小程序 sdk version|
|mpv|小程序平台版本,如微信、支付宝等|
|mpn|原生平台包名、小程序 appid|
|v|应用版本。原生应用|
|p|手机系统,`类型见下文`|
|net|网络类型,`类型见下文`|
|brand|手机品牌|
|md	|手机型号 model|
|lang|语言|
|lat|纬度|
|lng|经度|
|pr	|pixelRatio 设备像素比|
|ww	|windowWidth 可使用窗口宽度|
|wh	|windowHeight 可使用窗口高度|
|sw	|screenWidth 屏幕宽度|
|sh	|screenHeight 屏幕高度|
|url|当前页面的完整 url,包含参数在内。最多255字符|
|ch	|渠道信息|
|fvts|首次访问时间戳|
|lvts|上次访问时间戳|
|cn	|国家|
|pn	|省份|
|ct	|城市|
|sc	|场景值|
|tvc|用户到本次访问为止总共的访问次数|
|usv|统计 sdk 版本|
|t|上报数据时的时间戳|


**应用进入后台**

应用进入后台时,在 SDK 中是应用的 onHide 生命周期触发

|上报字段|说明|
|:-:|:-:|
|lt			|统计数据类型,默认值为3,`类型见下文`|
|ut			|平台类型,`类型见下文`|
|p			|手机系统,`类型见下文`|
|urlref		|应用退出时停留的页面|
|urlref_ts	|应用退出时,最后一个页面的停留时间|
|ch			|渠道信息|
|usv		|统计 sdk 版本|
|t			|上报数据时的时间戳|


**页面切换**

页面跳转时上报,在 SDK 中是页面的 onHide 生命周期触发

|上报字段|说明|
|:-:|:-:|
|lt|统计数据类型,默认值为11,`类型见下文`|
|ut	|平台类型,`类型见下文`|
|p|手机系统,`类型见下文`|
|url|当前页面的完整 url,包含参数在内。最多255字符|
|ttpj|pages.json 中定义的页面的 title|
|ttn|通过API uni.setnavigationbartitle 设置的 title|
|ttc|通过 uni.report 上报的页面的 title|
|ttct|title 组件中设置的 title|
|urlref		|应用退出时停留的页面|
|urlref_ts	|应用退出时,最后一个页面的停留时间|
|ch	|渠道信息|
|usv|统计 sdk 版本|
|t|上报数据时的时间戳|

**事件触发**

用户触发某些业务逻辑时
- 默认事件
    - 登录:用户信息
    - 支付:商品名称、金额
    - 分享:
- 用户自定义事件

|上报字段|说明|
|:-:|:-:|
|lt|统计数据类型,默认值为21,`类型见下文`|
|ut	|平台类型,`类型见下文`|
|p|手机系统,`类型见下文`|
|url|当前页面的完整 url,包含参数在内。最多255字符|
|e_n|事件名称|
|e_v|事件参数|
|ch	|渠道信息|
|usv|统计 sdk 版本|
|t|上报数据时的时间戳|

**应用错误**

应用发生错误时上报

|上报字段|说明|
|:-:|:-:|
|lt|统计数据类型,默认值为21,`类型见下文`|
|ut	|平台类型,`类型见下文`|
|p|手机系统,`类型见下文`|
|ch|渠道信息|
|mpsdk|小程序 SDK Version|
|mpv|小程序平台版本,如微信、支付宝等|
|v|应用版本。原生应用|
|em|错误信息|
|usv|统计 sdk 版本|
|t|上报数据时的时间戳|


**`lt`:统计数据类型**

|值|说明|
|:-:|:-:|
|1  |应用启动,对应 `onLaunch` 事件|
|3  |应用进入后台,对应应用 `onHide` 事件|
|11 |页面跳转,对应页面 `onHide` 事件|
|21 |事件触发|
|31 |应用错误|

**`ut`:平台类型**

|值|说明|
|:-:|:-:|
M
mehaotian 已提交
613 614 615 616 617 618 619 620 621 622 623
|n|移动端  |
|h5|h5	  |
|wx|微信	  |
|ali|阿里	  |
|bd|百度	  |
|tt|头条	  |
|qq|qq	  |
|qn|快应用  |
|ks|快手	  |
|lark|飞书	  |
|qw|快应用  |
F
fasttian 已提交
624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734
|dt| 钉钉	  |

**`p`:手机系统**

|值|说明|
|:-:|:-:|
|a|Android|
|i|iOS|


**`net`:网络类型**

|值|说明|
|:-:|:-:|
|wifi|wifi网络|
|2g|2g网络|
|3g|3g网络|
|4g|4g网络|
|5g|5g网络|
|none|无网络|
|cable|有线|

### 云端统计

#### 统计报表展示页

为了突出目标,仅注释出 uni 统计相关的文件夹及文件,其余与普通 uni-app 项目相同。新增页面可参考 uni-stat 中相似页面。

```bash
├── cloudfunctions
├── common                             # 样式
│   │── uni.css                        # 公共样式
│   └── uni-icons.css                  # icon样式
├── components                         # 自定义组件
├── js_sdk                             # js sdk
│   └── uni-stat                       # uni统计相关工具方法
│       └── util.js                      
├── pages                              # 页面
│   └── uni-stat                       # uni统计页面
│       │── channel                    # 渠道(app)
│       │   │── channel.vue            # 页面(下同)
│       │   └── fieldsMap.js           # 字段配置(下同)
│       │── device                     # 设备统计
│       │   │── activity               # 渠道/场景分析
│       │   │   │── activity.vue      
│       │   │   └── fieldsMap.js    
│       │   │── comparison             # 平台对比
│       │   │   │── comparison.vue      
│       │   │   └── fieldsMap.js    
│       │   │── overview               # 今日概览
│       │   │   │── overview.vue      
│       │   │   └── fieldsMap.js    
│       │   │── retention              # 留存
│       │   │   │── retention.vue      
│       │   │   └── fieldsMap.js    
│       │   │── stickiness             # 粘性
│       │   │   │── stickiness.vue      
│       │   │   └── fieldsMap.js    
│       │   └── trend                  # 趋势分析
│       │       │── trend.vue           
│       │       └── fieldsMap.js        
│       │── error                      # 错误分析
│       │   │── error.vue             
│       │   └── fieldsMap.js            
│       │── event                       # 事件分析
│       │   │── event.vue             
│       │   └── fieldsMap.js            
│       │── index                       # 统计首页
│       │   │── index.vue             
│       │   └── fieldsMap.js            
│       │── page-ent                    # 入口页
│       │   │── page-ent.vue             
│       │   └── fieldsMap.js            
│       │── page-res                    # 受访页
│       │   │── page-res.vue             
│       │   └── fieldsMap.js            
│       │── scene                       # 场景值(小程序)
│       │   │── scene.vue             
│       │   └── fieldsMap.js            
│       └── user                        # 用户统计
│           │── activity                # 渠道/场景分析
│           │   │── activity.vue      
│           │   └── fieldsMap.js    
│           │── comparison              # 平台对比
│           │   │── comparison.vue      
│           │   └── fieldsMap.js    
│           │── overview                # 今日概览
│           │   │── overview.vue      
│           │   └── fieldsMap.js    
│           │── retention               # 留存
│           │   │── retention.vue      
│           │   └── fieldsMap.js    
│           │── stickiness              # 粘性
│           │   │── stickiness.vue      
│           │   └── fieldsMap.js    
│           └── trend                   # 趋势分析
│               │── trend.vue           
│               └── fieldsMap.js        
├── static
├── store
├── admin.config.js
├── App.vue
├── main.js
├── mainfest.json
├── pages.json
├── postcss.config.js
└── uni.scss
```



hbcui1984's avatar
hbcui1984 已提交
735
#### 云函数、通用模块说明
M
mehaotian 已提交
736 737 738 739 740 741 742 743 744 745 746 747 748 749

**一、 uni统计服务端构成**

- `uni-config-center/uni-stat 配置模块`:给uni统计提供运行必要的配置参数。
- `uni-stat 公共模块`:数据处理模块,包括收集上报数据的处理入库及定时任务的数据处理。
- `uni-stat-receiver 上报数据接收器`:接收客户端上报数据并转发给公共模块处理。注意:该云对象依赖于`uni-id`公共模块。
- `uni-stat-cron 定时任务云函数`:触发定时任务并转发给公共模块处理。

**二、公共模块说明**

::: warning 注意
注意:uni统计公共模块依赖于 uniCloud配置中心(uni-config-center)
:::

M
mehaotian 已提交
750
``` bash
M
mehaotian 已提交
751 752 753 754 755 756 757 758 759 760 761
├── shared                              # 公共模块,提供公共函数库等支持。
│   │── create-api.js                   # 用来创建对外访问的实例
│   │── error.js                   		# 错误处理模块
│   │── index.js                   		# 入口文件,提供对外访问的基础模块
│   └── utils.js                     	# 工具函数库文件
├── stat                                # uni统计实际业务处理模块
│   │── lib                             # 工具类类库,提供日期计算、数据加密等额外功能支持。
│   │   │── date.js                     # 日期计算类文件
│   │   │── index.js                    # 入口文件,提供对外访问模块
│   │   └── uni-crypto.js               # 数据加密类文件,提供AES/MD5加密
│   │── mod                             # 数据模型,提供具体业务实现。
M
mehaotian 已提交
762 763 764
│   │   │── activeDevices.js            # 活跃设备模型,给周月维度的设备基础统计和留存统计提供数据,每日跑批合并,仅添加本周/本月首次访问的设备。
│   │   │── activeUsers.js              # 活跃用户模型,给周月维度的用户基础统计和留存统计提供数据,每日跑批合并,仅添加本周/本月首次访问的用户。
│   │   │── appCrashLogs.js             # 原生应用崩溃日志模型,记录原生应用的崩溃日志
M
mehaotian 已提交
765
│   │   │── base.js                     # 基类模型,提供基础服务支持
M
mehaotian 已提交
766 767 768 769 770 771
│   │   │── channel.js                  # 渠道模型,提供渠道和场景值数据
│   │   │── errorLog.js                 # 错误日志模型,记录上报的应用运行错误日志
│   │   │── errorResult.js              # 错误结果统计模型,统计汇总错误日志中的数据
│   │   │── event.js                    # 事件统计模型,提供应用的事件字典
│   │   │── eventLog.js                 # 事件日志模型,记录上报的事件日志
│   │   │── eventResult.js              # 事件结果统计,统计汇总事件日志中的数据
M
mehaotian 已提交
772
│   │   │── index.js                    # 入口文件,提供对外访问模块
M
mehaotian 已提交
773 774 775 776 777 778 779 780 781 782 783 784 785
│   │   │── loyalty.js                  # 设备/用户忠诚度(粘性)统计模型,统计设备/用户的粘性,粘性判断依据为:访问时长和访问页面数量
│   │   │── page.js                     # 页面模型,提供应用的页面字典
│   │   │── pageLog.js                  # 页面日志模型,记录上报的页面访问日志
│   │   │── pageResult.js               # 页面结果统计模型,统计汇总页面访问日志中的数据
│   │   │── platform.js                 # 应用平台模型,提供应用的平台字典
│   │   │── runErrors.js                # 运行错误日志,记录数据统计时运行出错的日志
│   │   │── scenes.js                   # 场景值模型,提供应用渠道和小程序场景值的数据字典
│   │   │── sessionLog.js               # 基础会话日志模型,记录设备访问时产生的会话日志
│   │   │── shareLog.js                 # 分享日志模型,记录触发分享事件的日志
│   │   │── statResult.js               # 基础数据结果统计模型,统计汇总会话数据包括不限于设备/用户的数量、访问量、活跃度(日活、周活、月活)、留存率(日留存、周留存、月留存)、跳出率、访问时长等数据
│   │   │── uniIDUsers.js               # uni-id 用户模型,提供uni-id用户数据查询
│   │   │── userSessionLog.js           # 用户会话日志模型,记录登录用户的会话日志
│   │   └── version.js                  # 应用版本模型,提供应用的版本号字典
M
mehaotian 已提交
786 787 788 789 790
│   │── receiver.js                     # 上报数据接收器,数据上报功能的分发入口文件
│   └── stat.js                         # 数据统计调度处理模块,数据统计及日志清理功能的分发入口文件
└── index.js                            # 代理入口文件,提供对外访问的uni-stat对象
```

M
mehaotian 已提交
791
#### 公共模块配置项说明
M
mehaotian 已提交
792 793 794 795 796 797 798 799
uni统计配置项存放于uniCloud配置中心(`uni-config-center`)下的 `uni-stat/config.json`文件中,用户可根据自身系统需要自定义各配置项的值。

::: warning 注意
注意:修改uni统计配置项后需要重新上传公共模块`uni-config-center`后才会生效。
:::

**基础参数**

F
fasttian 已提交
800 801
|配置项				|默认值		|说明																																																|
| :--------:		|:---------:|:-------------------:																																												|
M
mehaotian 已提交
802
|  debug			|  false	|开启调试模式 true: 开启,false:关闭,开启后会产生大量日志,生产环境请关闭。																														|
F
fasttian 已提交
803
|  redis			|  false	|开启redis缓存,开启后可以降低数据库查询压力,提升uni统计性能,可按需决定是否开启。[开启方法](#开启redis缓存)																					|
M
mehaotian 已提交
804 805
|  cachetime		|  604800	|redis缓存有效期,单位秒。																																											|
|  sessionExpireTime|  1800		|会话过期时间,该配置用来判断当前会话是否已过期,一般情况下无需修改此项。																															|
F
fasttian 已提交
806
|  realtimeStat		|  true		|开启实时统计,true: 开启,false:关闭,开启后会每小时统计一次,数据库读写次数会增多,可按需决定是否开启。																							|
JiaRongPing's avatar
JiaRongPing 已提交
807
|  cronMin			|  false	|开启分钟级定时任务,true: 开启,false:关闭。开启后定时任务将细分到分钟级执行,分摊数据计算压力,适合应用日活较大或有特殊需求的用户群体。具体的开启方法见[设置定时任务云函数的触发周期](#设置定时任务云函数的触发周期)。	|
M
mehaotian 已提交
808 809 810 811 812 813 814
|  cron				|  -		|用于配置定时任务触发时间,详情见下方[定时任务配置说明](#定时任务配置说明)。																														|
|  batchInsertNum	|  5000		|当有批量写入操作时,限制单次写入数据库的最大条数。为防止写入超时,最大值为5000条。																													|
|  errorCheck		|  -		|错误检测,此项用于在规定时间内限制相同的错误日志写入数据库,防止有高频错误产生时造成大量的数据库写入操作。[详情](#错误检测配置说明)																|
|  cleanLog			|  -		|日志清理,此项用于配置定时清理过期的日志,减少数据库数据的存储量,提升uni统计性能。[详情](#日志清理配置说明)																						|


#### 定时任务配置说明
F
fasttian 已提交
815

M
mehaotian 已提交
816 817 818 819 820 821 822
`cron` 参数用于配置定时任务触发时间,一般无需修改此项。

|参数		|说明																																|
| :--------:|:-------------------:																												|
|  type		|定时任务类型:如 `stat`:基础数据统计																								|
|  time		|触发时间表达式:`* * * *` 共四位,由左到右分别代表:星期(1-7代表周一到周日)/日/时/分。例:每天晚上0点0分触发,应写作 `* * 0 0`	|

M
mehaotian 已提交
823
目前定时任务类型有(`以下括号内的内容表示开启分钟级统计后定时任务的触发时间`):
M
mehaotian 已提交
824

F
fasttian 已提交
825 826 827 828 829 830 831
- `stat`:基础数据统计,统计维度包括:
  - 实时统计,默认`每小时(0分钟)`触发,统计上一小时的基础数据
  - 日统计,默认`每天上午1点(10分钟)`触发,统计前一天的基础数据
  - 周统计,默认`每周一上午1点(20分钟)`触发,统计上一周的基础数据
  - 月统计,默认`每月1号上午3点(30分钟)`触发,统计上一月的基础数据

- `retention-device`:设备留存数据统计,统计维度包括:
832 833 834
  - 日统计,默认`每天上午2点(20分钟)`触发,统计设备日留存数据(初始统计前天到昨天的留存情况,因此需至少运行三天才会有数据)
  - 周统计,默认`每周一上午2点(30分钟)`触发,统计设备周留存数据(初始统计上上周到上周的留存情况,因此需至少运行三周才会有数据)
  - 月统计,默认`每月1号上午4点(30分钟)`触发,统计设备月留存数据(初始统计上上月到上月的留存情况,因此需至少运行三个月才会有数据)
F
fasttian 已提交
835 836

- `retention-user`:用户留存数据统计,统计维度包括:
837 838 839
  - 日统计,默认`每天上午3点(40分钟)`触发,统计用户日留存数据(初始统计前天到昨天的留存情况,因此需至少运行三天才会有数据)
  - 周统计,默认`每周一上午5点(30分钟)`触发,统计用户周留存数据(初始统计上上周到上周的留存情况,因此需至少运行三周才会有数据)
  - 月统计,默认`每月1号上午6点(40分钟)`触发,统计用户月留存数据(初始统计上上月到上月的留存情况,因此需至少运行三个月才会有数据)
F
fasttian 已提交
840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855

- `active-device`:活跃设备数据归档,统计维度包括:
  - 日归档,默认`每天上午0点(10分钟)`触发,归档前一天的活跃设备数据,注意:此项数据要保持在`基础数据统计``设备留存数据统计``用户留存数据统计`中的周统计、月统计触发之前执行。

- `active-user`:活跃用户数据归档,统计维度包括:
  - 日归档,默认`每天上午0点(20分钟)`触发,归档前一天的活跃用户数据,注意:此项数据要保持在`基础数据统计``设备留存数据统计``用户留存数据统计`中的周统计、月统计触发之前执行。

- `page`:页面数据统计,统计维度包括:
  - 日统计,默认`每天上午3点(20分钟)`触发,统计前一天的页面数据

- `event`:事件数据统计,统计维度包括:
  - 日统计,默认`每天上午4点(20分钟)`触发,统计前一天的事件数据

- `error`:错误数据统计,统计维度包括:
  - 日统计,默认`每天上午5点(20分钟)`触发,统计前一天的错误数据

856 857 858
- `clean`:错误数据统计,统计维度包括:
  - 日志清理,默认`每天上午5点(30分钟)`触发,清理过期的日志数据

M
mehaotian 已提交
859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888


#### 错误检测配置说明

`errorCheck`参数用于在规定时间内限制相同的错误日志写入数据库,防止有高频错误产生时造成大量的数据库写入操作,可按需开启或关闭。

|参数		|说明								|
| :--------:|:-------------------:				|
| needCheck	|是否需要检测:true:是;false:否	|
| checkTime	|错误检测间隔时间,单位`分钟`。		|


#### 日志清理配置说明

`cleanLog`参数用于配置定时清理过期的日志,减少数据库数据的存储量,提升uni统计性能。

|参数			|说明																																								|
| :--------:	|:-------------------:																																				|
| open			|是否开启日志清理:true:是;false:否																																|
| reserveDays	|各项日志的保留天数配置,参数格式:`日志类型:保留天数`,例如: `sessionLog:31`代表保留31天的会话日志,保留天数设置为0时表示永久保留(此举会累积大量无用数据,不推荐)	|

目前可配置的日志类型有:

- `基础会话日志:sessionLog`,默认保留`31`天的日志。注意:因设备留存统计中最长需要统计30后的留存数据, 所以基础会话日志要至少保存`31`天的日志,否则会对设备留存统计造成影响。
- `用户会话日志:userSessionLog`,默认保留`31`天的日志。注意:因用户留存统计中最长需要统计30后的留存数据, 所以用户会话日志要至少保存`31`天的日志,否则会对用户留存统计造成影响。
- `页面日志:pageLog`,默认保留`7`天的日志。
- `事件日志:eventLog`,默认保留`7`天的日志。
- `分享日志:shareLog`,默认保留`7`天的日志。
- `错误日志:errorLog`,默认保留`7`天的日志。

F
fasttian 已提交
889 890 891 892 893 894
::: warning 注意事项
- 客户端和统计后台两个项目务必关联同一个服务空间,且uni-admin中所有云函数、公共模板等都已经上传部署到该服务空间
- 使用 uni 统计必须配置 APPID 才能正常使用。[DCloud的Appid有什么用,如需转让应用怎么做](https://ask.dcloud.net.cn/article/35907)
- 应用在运行、调试时不会上报统计数据,仅在发行后,并启动新版的App、h5、小程序,才会上报数据。
- 不支持 CLI 项目
:::
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
895

M
mehaotian 已提交
896

M
mehaotian 已提交
897
## 扩展和自定义方式
F
fasttian 已提交
898 899
uni统计提供了基础的数据报表,如不能达到预期的数据采集,可以在客户端通过 `uni.report(eventKey,param)`  自由上报数据 ,并通过 uni-admin 增加页面 ,自行统计数据。

M
mehaotian 已提交
900
### 前端 uni.report 基础用法 
F
fasttian 已提交
901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921

这里列出 `uni.report(eventKey,param)` 的基本用法,完整`API`查看:[详情](https://uniapp.dcloud.io/api/other/report.html)

`uni.report(eventKey,param)` 有两个参数。
- eventKey  自定义事件名称
- param		自定义事件参数

``` js
// 参数支持字符串
uni.report('购买','购买成功')

// 参数支持对象
uni.report('购买',{
	id:'1000',
	name:'上衣',
	price:'998',
	msg:'购买成功'
	// ...
})
```

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
922 923 924 925 926 927
### uni-admin 中使用自定义事件上报的数据
在 uni-admin 中新增页面,使用 [uniCloud API](https://uniapp.dcloud.io/uniCloud/clientdb#clientdb%E7%AE%80%E4%BB%8B) 获取所有 `uni-report` 上报的原始数据,数据存放于 [uni-stat-event-logs](https://gitee.com/dcloud/opendb/tree/master/collection/uni-stat-event-logs) 表中。

- 获取数据后,可以自行扩展所需业务逻辑

```js
M
mehaotian 已提交
928 929 930
const db = uniCloud.database()
db.collection('uni-stat-event-logs')
```
931

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
932 933 934 935 936
不管是新上报的数据,还是[opendb](https://uniapp.dcloud.net.cn/uniCloud/opendb.html)的数据、或者开发者自己的业务数据库里的数据,都可以自己编写报表进行统计分析。

与普通uni-app页面一样,新建页面,编写代码。

`uni-admin`中注册左侧菜单时,需要参考文档:[uni-admin 左侧窗口-菜单栏](https://uniapp.dcloud.io/uniCloud/admin.html#%E5%B7%A6%E4%BE%A7%E7%AA%97%E5%8F%A3-%E8%8F%9C%E5%8D%95%E6%A0%8F)
937

hbcui1984's avatar
hbcui1984 已提交
938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989
## 版本升级 @upgrade

`uni-admin1.9.0`版本开始(对应`HBuilderX 3.5.1`),`uni统计``uni升级中心`复用相同的应用版本表(即`opendb-app-versions`表) ,废弃原来的`uni-stat-app-versions`表。

如果你已启用`uni统计2.0`,但使用的是老版本的`uni-admin`,则需注意版本表的迁移升级,否则基于版本的统计数据可能不准确。

升级步骤:

1. 从插件市场更新`uni-admin`项目
2. 上传覆盖`uni-stat`公共模块
3. 重新上传覆盖所有的`DB Schema`
4. 将原`uni-stat-app-versions`表中的数据导入到`opendb-app-versions`表中;如下提供了一个代码片段,你可以创建一个云函数,将示例代码拷贝到云函数中,右键执行 “运行-本地云函数”,即可自动完成数据内容的迁移;

```
'use strict';
const db = uniCloud.database()
exports.main = async (event, context) => {
	const oldVersionDataRes = await db.collection('uni-stat-app-versions')
		.aggregate()
		.lookup({
			from: 'uni-stat-app-platforms',
			localField: 'platform_id',
			foreignField: '_id',
			as: 'platform'
		})
		.limit(500)
		.end()

	if (oldVersionDataRes.data.length) {
		for (let oldKey in oldVersionDataRes.data) {
			//老版本表的数据
			const oldVersionData = oldVersionDataRes.data[oldKey]
			
			//组装数据
			const newVersionData = {
				_id: oldVersionData._id,//_id 两个表数据要保持一致
				appid: oldVersionData.appid,//appid
				platform: [],//默认为空数组即可
				uni_platform: oldVersionData.platform[0].code,//平台代码
				type: 'native_app',//类型 默认为native_app即可
				version: oldVersionData.version,
				create_env: 'uni-stat',//创建来源,设置为uni-stat
				create_date: oldVersionData.create_time//创建时间
			}
			await db.collection('opendb-app-versions').add(newVersionData)
		}
	}
	
	return true
};
```

990 991 992 993 994 995
## 常见问题

**1. 启动uni统计后,何时可以查看报表数据?**

答:与定时任务配置配置有关,默认`统计首页``今日概况`等数据为1小时后可见,其余数据为次日可见。要想详细了解各类型数据统计时间请参考[定时任务配置说明](#定时任务配置说明)

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
996
**2. 已经开启统计,定时任务配置也正常,但是后台还是看不到数据**
997

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
998
答:
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
999 1000 1001 1002
- 确保分清楚,业务App 和 admin 是2个工程。业务App是采集端,admin是报表端
- 确保使用HBuilderX 3.4.14+。如果是cli创建的项目,需要升级cli到uni-app 3.4.14+
- 确保在需要统计的业务App工程的manifest里勾选了开启 uni统计2.0,并关联和正确的uniCloud服务空间
- 确保重新发行过业务App(在HBuilder里发行即可,不需要上架应用商店或小程序商店),数据上报只发生在项目发行后或者运行项目开启了调试模式,其他情况不会上报数据。[详情](#report-time)
hbcui1984's avatar
hbcui1984 已提交
1003
- 确保`uni-admin`项目的`uniCloud`目录下的云函数都上传到了与App相同的uniCloud服务空间
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
1004
-[uniCloud web控制台](https://unicloud.dcloud.net.cn/)的云函数日志中,可以看到`uni-stat-receiver`云函数有正确的请求日志
hbcui1984's avatar
hbcui1984 已提交
1005 1006
-[uniCloud web控制台](https://unicloud.dcloud.net.cn/)的云函数日志中,可以看到`uni-stat-cron`云函数有定时执行日志,且日志显示执行成功;如日志中显示`Not Found the cofnig file`,则查看下方第6个问题;
- 如需看`uni-admin`这个管理端的统计数据,才需要在`uni-admin`工程的`manifest`里配置`uni统计2.0`并再次发行。再次强调不要搞混业务App和admin
1007

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
1008
**3. 如何判断是否需要配置分钟级定时任务?**
1009

DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
1010
答:一般情况下是不需要自行配置的,但如果`定时任务云函数(uni-stat-cron)`出现运行超时的情况时,就要考虑去开启分钟级定时任务了。
1011 1012 1013 1014 1015 1016 1017 1018

**4. 如何创建或授权`uni统计`运营管理员账号**

答:参考[uni-admin 给系统创建多个登录账户并设置不同的权限](https://uniapp.dcloud.net.cn/uniCloud/admin.html#mutiladmin)

**5. 为什么总设备数比活跃设备数少?**

答:总设备数计算公式为:总设备数 = 原设备数 + 新设备数,而判断一个设备是否为新设备的依据是在客户端SDK中是否已储存该设备上次访问某一应用的时间,未存储则认为是该应用的新设备(即lvts=0时为新设备,lvts>0为老设备)。 因此如果之前某一设备已经访问过某一应用,就算此时清除数据库中的数据,由于已经在客户端SDK中储存该设备上次访问应用的时(即此时lvts > 0),所以该设备也不会再被认为是该应用的新设备从而不会再被计算进该应用的总设备数中而只会计算进活跃设备数中,此时可能就会出现总设备数小于活跃设备数的情况。
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
1019

hbcui1984's avatar
hbcui1984 已提交
1020 1021 1022 1023
**6. uni-stat-cron运行日志显示 Not Found the cofnig file** 

业务App 和 admin 是2个工程。业务App是采集端,admin是报表端;这两个项目均包含`uni-config-center`;如果这两个项目关联(复用)相同的服务空间时,很容易出现`uni-config-center`的互相覆盖问题;此时建议单点维护,方案有2种:
- 以业务App为主:将`uni-admin`项目中`uni-config-center` 下面的`uni-stat`文件夹,复制到业务App项目下的`uni-config-center`目录下,然后重新上传业务App项目下的`uni-config-center`公共模块即可。
hbcui1984's avatar
hbcui1984 已提交
1024
-`uni-admin`为主:将业务App项目下的`uni-config-center`,手动合并配置项到`uni-admin`项目下的`uni-config-center`中(注意:是手动合并配置项,不要整体覆盖文件),然后重新上传`uni-admin`项目下的`uni-config-center`公共模块即可。
hbcui1984's avatar
hbcui1984 已提交
1025

hbcui1984's avatar
hbcui1984 已提交
1026
## 参考资料
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
1027

hbcui1984's avatar
hbcui1984 已提交
1028
不掌握如下文档,很难对 `uni统计2.0` 吃透和做二次开发
DCloud_Heavensoft's avatar
DCloud_Heavensoft 已提交
1029 1030
- uni-admin文档:[详见](https://uniapp.dcloud.net.cn/uniCloud/admin.html)
- uni-id文档:[详见](https://uniapp.dcloud.net.cn/uniCloud/uni-id.html)
hbcui1984's avatar
hbcui1984 已提交
1031
- opendb文档:[详见](https://uniapp.dcloud.net.cn/uniCloud/opendb.html)