Skip to content

unidocs-zh
unidocs-zh

DCloud / unidocs-zh

通知 3201
Star 106
Fork 814
unidocs-zh
unidocs-zh
提交 d1f0b581 编写于 作者: DCloud_Heavensoft's avatar DCloud_Heavensoft
浏览文件
操作

Update uni-stat-v2.md

上级 e0fb4a6a
隐藏空白更改
内联 并排
Showing with 1048 addition and 1043 deletion
docs/uni-stat-v2.md
浏览文件 @ d1f0b581
uni统计2.0 是开源、全端、云端一体、更适合uni-app的统计平台。 uni统计2.0 是开源、全端、云端一体、更适合uni-app的统计平台。
> `HBuilderX 3.4.10 +`起支持 > `HBuilderX 3.4.10 +`起支持
## demo体验 ## demo体验
体验系统：[https://hellouniadmin.dcloud.net.cn/](https://hellouniadmin.dcloud.net.cn/) 体验系统：[https://hellouniadmin.dcloud.net.cn/](https://hellouniadmin.dcloud.net.cn/)
注：uni统计内置在[uni-admin](/uniCloud/admin)中，体验系统的数据会定期重置。 注：uni统计内置在[uni-admin](/uniCloud/admin)中，体验系统的数据会定期重置。
![](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/28ddae77-dda6-448f-86aa-7e59bb7c4f8d.png) ![](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/28ddae77-dda6-448f-86aa-7e59bb7c4f8d.png)
## 产品特色 ## 产品特色
无需开发，在`manifest`的 `uni统计` 中打勾并发行，在[uniCloud](/uniCloud/)服务空间部署[uni-admin](/uniCloud/admin)，即可查看报表。 无需开发，在`manifest`的 `uni统计` 中打勾并发行，在[uniCloud](/uniCloud/)服务空间部署[uni-admin](/uniCloud/admin)，即可查看报表。
同时开发者也可以自定义打点数据、自定义展现报表。 同时开发者也可以自定义打点数据、自定义展现报表。
**1. 全端** **1. 全端**
全端流量统计，一张报表可查看所有端（iOS、Android、Web 及各家小程序）的运营数据。 全端流量统计，一张报表可查看所有端（iOS、Android、Web 及各家小程序）的运营数据。
无需在各端接不同的sdk、无需在不同报表看数据。目前市面已知唯一一个一张报表看遍业务全景的方案。 无需在各端接不同的sdk、无需在不同报表看数据。目前市面已知唯一一个一张报表看遍业务全景的方案。
**2. 开源、免费、自由定制** **2. 开源、免费、自由定制**
无论前端采集数据的SDK、云端接收数据的云函数、云端跑批统计的云函数、展示统计结果的报表，所有这些代码全部开源。 无论前端采集数据的SDK、云端接收数据的云函数、云端跑批统计的云函数、展示统计结果的报表，所有这些代码全部开源。
前端自定义打点，后端自定义统计维度，自由定制报表，一切都可以灵活定制。 前端自定义打点，后端自定义统计维度，自由定制报表，一切都可以灵活定制。
**3. 私有部署、数据自控** **3. 私有部署、数据自控**
使用传统saas类统计产品，所有数据都上报给统计服务厂商。 使用传统saas类统计产品，所有数据都上报给统计服务厂商。
`uni统计2.0`基于`uniCloud`实现，云函数、统计数据全部托管在开发者自己的服务空间（阿里云或腾讯云自选）中，开发者对自己的统计数据拥有完整的控制权。 `uni统计2.0`基于`uniCloud`实现，云函数、统计数据全部托管在开发者自己的服务空间（阿里云或腾讯云自选）中，开发者对自己的统计数据拥有完整的控制权。
**4. 默认功能丰富** **4. 有效的错误分析**
- 设备统计 传统App统计平台，都没有js错误统计。开发者无法了解到自己的js代码在哪些设备上会报错。
- 注册用户统计（基于[uni-id](https://uniapp.dcloud.io/uniCloud/uni-id.html)）
- 页面统计 uni统计的错误信息更全面，包括 js前端错误和 App 原生层的崩溃。
- 新增、活跃、留存、跳出率分析
- 渠道分析：辅助渠道推广 因为uni-app是编译后运行，传统web和小程序的统计平台，其js报错无法回溯到uni-app的编译前源码，报错看不懂。
- 错误统计和上报：辅助产品质量提升
- 原生App崩溃统计，分版本查看崩溃率 uni统计支持sourcemap，可直观了解到底哪行代码写的有问题。[详见](#sourcemap-parse-error)
- 自定义打点、开源可扩展的报表
**5. 有效的错误分析** **5. 默认功能丰富**
传统统计平台，都没有js错误统计。开发者无法了解到自己的js代码在哪些设备上会报错。 - 设备统计
- 注册用户统计（基于[uni-id](https://uniapp.dcloud.io/uniCloud/uni-id.html)）
uni统计的错误信息更全面，包括 js前端错误和 App 原生层的崩溃。辅助开发者把应用做的更好。 - 页面统计
- 新增、活跃、留存、跳出率分析
**6. 更适合uni-app和uniCloud** - 渠道分析：辅助渠道推广
- 错误统计和上报：辅助产品质量提升
uni统计深入uni-app和uniCloud框架底层，提供了众多其他统计平台无法提供的功能： - 原生App崩溃统计，分版本查看崩溃率
- uni-app全端识别，无需对接不同sdk、无需在不同报表中切换和自己累加数据 - 自定义打点、开源可扩展的报表
- 自动识别uni-app路由，自动采集页面标题（基于pages.json的navigationBar或uni-nav-bar组件）
- 自动捕获js错误，上报app端原生崩溃日志 **6. 更适合uni-app和uniCloud**
- 兼容uni-app渠道包打包体系，自动识别渠道包
- 基于uni-id账户体系，自动出具注册用户（不是设备）的新增、活跃、留存报表 uni统计深入uni-app和uniCloud框架底层，提供了众多其他统计平台无法提供的功能：
- 兼容uniCloud [opendb规范](/uniCloud/opendb)，从服务器端统计各项数据 - uni-app全端识别，无需对接不同sdk、无需在不同报表中切换和自己累加数据
- 自动识别uni-app路由，自动采集页面标题（基于pages.json的navigationBar或uni-nav-bar组件）
**7. 开放生态** - 自动捕获js错误，上报app端原生崩溃日志
- 兼容uni-app渠道包打包体系，自动识别渠道包
uni统计的开源且基于[uni-admin](/uniCloud/admin)的插件规范提供了插件机制，会有更多插件作者提供各种丰富的统计插件（如电商统计、内容统计等）。见[插件市场](https://ext.dcloud.net.cn/?cat1=7&cat2=74&type=HotList) - 基于uni-id账户体系，自动出具注册用户（不是设备）的新增、活跃、留存报表
- 兼容uniCloud [opendb规范](/uniCloud/opendb)，从服务器端统计各项数据
**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统计产品的基础上，完成迭代更新。** **7. 开放生态**
uni统计的开源且基于[uni-admin](/uniCloud/admin)的插件规范提供了插件机制，会有更多插件作者提供各种丰富的统计插件（如电商统计、内容统计等）。见[插件市场](https://ext.dcloud.net.cn/?cat1=7&cat2=74&type=HotList)
## uni 统计老版升级建议
**DCloud非常重视数据驱动开发者业务的增长，近期联合专业的大数据服务商<a href="https://www.sensorsdata.cn/" target="_blank">神策</a>和<a href="https://tj.aldwx.com/" target="_blank">阿拉丁</a>共同完善Uni统计2.0的产品模块和生态建设。
对于使用uni统计1.0的开发者，推荐尽快升级到uni统计2.0。uni统计1.0将不再更新维护。 如果你对数据分析有任何需求，欢迎您填写<a href="https://sdmarketing.wjx.cn/vj/h2UFHnx.aspx" target="_blank">需求调研问卷</a>，我们会根据您的宝贵建议，在原有Uni统计产品的基础上，完成迭代更新。**
|功能|uni统计1.0|uni统计2.0|
| :-: | :-: | :-: | ## uni 统计老版升级建议
|是否开源 |否|是|
|部署方式 |中央部署|私有部署| 对于使用uni统计1.0的开发者，推荐尽快升级到uni统计2.0。uni统计1.0将不再更新维护。
|定制方式 |不可定制|自由定制|
|uni-id用户统计 |不含|默认包含| |功能|uni统计1.0|uni统计2.0|
|错误分析有效性|较低|较高| | :-: | :-: | :-: |
|是否开源 |否|是|
|部署方式 |中央部署|私有部署|
## 环境要求 |定制方式 |不可定制|自由定制|
- uni统计2.0 在客户端仅支持uni-app，非uni-app无法使用。 |uni-id用户统计 |不含|默认包含|
- uni统计2.0 在云端虽然依赖uniCloud，但并不要求开发者的应用全部基于uniCloud开发。应用的主业务可以连接传统服务器，统计打点、报表展现使用uniCloud即可。 |错误分析有效性|较低|较高|
## 使用教程 ## 环境要求
- uni统计2.0 在客户端仅支持uni-app，非uni-app无法使用。
`uni统计2.0`包括两个模块： - uni统计2.0 在云端虽然依赖uniCloud，但并不要求开发者的应用全部基于uniCloud开发。应用的主业务可以连接传统服务器，统计打点、报表展现使用uniCloud即可。
- 前端采集模块：内置在`uni-app`框架中，在业务App的`manifest.json`进行配置；
- 云端统计模块：内置在`uni-admin`项目模板中，和业务App复用同样的uniCloud服务空间；
## 使用教程
### 前端采集配置
`uni统计2.0`包括两个模块：
在业务App项目的 `manifest.json` 里，选择 `uni统计配置` 项，根据需求，选择开通 `uni统计` ，勾选 `2.0` 开启新版统计。 - 前端采集模块：内置在`uni-app`框架中，在业务App的`manifest.json`进行配置；
- 云端统计模块：内置在`uni-admin`项目模板中，和业务App复用同样的uniCloud服务空间；
![开启统计](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/14b2b045-3d8e-4535-acad-2e745441c816.png)
### 前端采集配置
上述可视化操作，其实对应manifest源码视图的 `uniStatistics` 节点。如下文档对manifest规范进行详述。**如不关心规范细节，可以不阅读本小节，继续看下一节《小程序域名白名单》**。
在业务App项目的 `manifest.json` 里，选择 `uni统计配置` 项，根据需求，选择开通 `uni统计` ，勾选 `2.0` 开启新版统计。
`uniStatistics` 下的 `enable` 字段设置为 `true|false`，来开启关闭 `uni统计`
![开启统计](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/14b2b045-3d8e-4535-acad-2e745441c816.png)
设置 `version` 属性为 `"2"` 来开启新版统计
上述可视化操作，其实对应manifest源码视图的 `uniStatistics` 节点。如下文档对manifest规范进行详述。**如不关心规范细节，可以不阅读本小节，继续看下一节《小程序域名白名单》**。
```js
//... `uniStatistics` 下的 `enable` 字段设置为 `true|false`，来开启关闭 `uni统计`
"uniStatistics": {
"enable": true,//全局开启 设置 `version` 属性为 `"2"` 来开启新版统计
"version": "2" // 开启新版uni统计，值为字符串
}, ```js
//... //...
``` "uniStatistics": {
"enable": true,//全局开启
**uniStatistics说明** "version": "2" // 开启新版uni统计，值为字符串
},
|字段|类型|默认值|可选值|说明| //...
|:-:|:-:|:-:|:-:|:-:| ```
|enable|Boolean|false|true ， false|全局开启或关闭统计 ，分平台配置会覆盖当前配置|
|version|String|"1"|"1" ， "2"|统计版本 ，如不填写，默认使用版本1.0，推荐使用2.0版本| **uniStatistics说明**
|debug|Boolean|false|true ， false|开启统计调试模式 ，会产生大量日志，且会在开发阶段上报数据，应用发布请关闭此项|
|reportInterval|Number|10|true ， false|前端数据上报周期 **HBuilderX 3.5.4+ 支持**| |字段|类型|默认值|可选值|说明|
|collectItems|Object|-|-|采集项配置 **HBuilderX 3.5.5+ 支持**| |:-:|:-:|:-:|:-:|:-:|
|enable|Boolean|false|true ， false|全局开启或关闭统计 ，分平台配置会覆盖当前配置|
**collectItems 采集项配置说明** |version|String|"1"|"1" ， "2"|统计版本 ，如不填写，默认使用版本1.0，推荐使用2.0版本|
|debug|Boolean|false|true ， false|开启统计调试模式 ，会产生大量日志，且会在开发阶段上报数据，应用发布请关闭此项|
|字段|类型|默认值|可选值|说明| |reportInterval|Number|10|true ， false|前端数据上报周期 **HBuilderX 3.5.4+ 支持**|
|:-:|:-:|:-:|:-:|:-:| |collectItems|Object|-|-|采集项配置 **HBuilderX 3.5.5+ 支持**|
|uniPushClientID|Boolean|false|true/false|是否开启推送`PushClientID`的采集|
**collectItems 采集项配置说明**
**分平台设置**
|字段|类型|默认值|可选值|说明|
`uniStatistics` 支持分平台设置，比如仅开启微信小程序平台的 `uni统计`，则在`mp-weixin`节点下设置 `uniStatistics ->enable` 即可，如下： |:-:|:-:|:-:|:-:|:-:|
|uniPushClientID|Boolean|false|true/false|是否开启推送`PushClientID`的采集|
```js
//... **分平台设置**
"mp-weixin":{
"uniStatistics": { `uniStatistics` 支持分平台设置，比如仅开启微信小程序平台的 `uni统计`，则在`mp-weixin`节点下设置 `uniStatistics ->enable` 即可，如下：
"enable": true //微信平台开启统计
} ```js
} //...
``` "mp-weixin":{
"uniStatistics": {
**分平台uniStatistics说明** "enable": true //微信平台开启统计
}
|字段|类型|默认值|可选值|说明| }
|:-:|:-:|:-:|:-:|:-:| ```
|enable|Boolean|false|true ， false|分平台开启或关闭统计 ，分平台配置会覆盖全局配置，uniStatistics 需在平台配置下|
**分平台uniStatistics说明**
::: warning 注意
- 在分平台下如有`uniStatistics -> enable`字段，则优先使用分平台下配置 ，反之使用全局统计设置 |字段|类型|默认值|可选值|说明|
- 分平台无需设置 `version`、`debug` 属性 ，两个属性仅全局生效 |:-:|:-:|:-:|:-:|:-:|
- 分平台无需设置 `debug` 属性 ，该属性仅在全局生效 |enable|Boolean|false|true ， false|分平台开启或关闭统计 ，分平台配置会覆盖全局配置，uniStatistics 需在平台配置下|
- 仅在开启调试模式或发行代码后才会正常上报数据
::: ::: warning 注意
- 在分平台下如有`uniStatistics -> enable`字段，则优先使用分平台下配置 ，反之使用全局统计设置
- 分平台无需设置 `version`、`debug` 属性 ，两个属性仅全局生效
#### 小程序域名白名单 - 分平台无需设置 `debug` 属性 ，该属性仅在全局生效
- 仅在开启调试模式或发行代码后才会正常上报数据
由于各家小程序对可访问的域名要配置白名单，否则无法联网。所以需要发布小程序时需要在各厂商的小程序管理后台配置域名白名单。 :::
部署uni统计时可以选择使用uniCloud的阿里云版或腾讯云版，不同云厂商对应的域名不同（文章后面章节会有服务空间相关配置）
#### 小程序域名白名单
| uniCloud服务提供商 | request 合法域名 |
| :--------: | :-------------------------: | 由于各家小程序对可访问的域名要配置白名单，否则无法联网。所以需要发布小程序时需要在各厂商的小程序管理后台配置域名白名单。
| 阿里云 | api.bspapp.com |
| 腾讯云 | tcb-api.tencentcloudapi.com | 部署uni统计时可以选择使用uniCloud的阿里云版或腾讯云版，不同云厂商对应的域名不同（文章后面章节会有服务空间相关配置）
根据选择的uniCloud云厂商，配置相应的域名到小程序的域名白名单配置里即可。 | uniCloud服务提供商 | request 合法域名 |
| :--------: | :-------------------------: |
#### 调试模式 | 阿里云 | api.bspapp.com |
| 腾讯云 | tcb-api.tencentcloudapi.com |
将 `manifest.json -> uniStatistics` 下的 `debug` 字段设置为 `true|false` ，来开启关闭 `uni统计`调试模式
根据选择的uniCloud云厂商，配置相应的域名到小程序的域名白名单配置里即可。
在调试模式下，会将上报数据的关键信息打印到控制台，方便观察采集信息是否正确 ，多用在自定义扩展的时候
#### 调试模式
**日志格式**
将 `manifest.json -> uniStatistics` 下的 `debug` 字段设置为 `true|false` ，来开启关闭 `uni统计`调试模式
`===` 表示统计日志相关日志
在调试模式下，会将上报数据的关键信息打印到控制台，方便观察采集信息是否正确 ，多用在自定义扩展的时候
``` js
// 标识统计开启 **日志格式**
=== uni统计开启,version:2.0
`===` 表示统计日志相关日志
// 采集日志，采集类型见 ：上报数据说明
=== 统计数据采集：{采集类型} === ``` js
// 这里是采集的原始数据 // 标识统计开启
{ === uni统计开启,version:2.0
fvts: 1647313662
lang: "zh" // 采集日志，采集类型见 ：上报数据说明
lt: "1" === 统计数据采集：{采集类型} ===
lvts: 1650857441 // 这里是采集的原始数据
md: "PC" {
t: 1650857461 fvts: 1647313662
ttpj: "view" lang: "zh"
tvc: 14 lt: "1"
url: "pages/component/view/view" lvts: 1650857441
usv: "0.0.1" md: "PC"
ut: "h5" 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) {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="]'}
=== 上报结束 ===
### 后台报表配置
```
#### 创建 admin 项目
日志字段说明，详见[前端采集SDK](#web-sdk)
`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统计的菜单并使用。
#### 创建 admin 项目
请参考[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)文档，完成如下操作：
`uni统计2.0`的后台统计报表是[uni-admin](https://uniapp.dcloud.io/uniCloud/admin.html)的内置插件。
1. 创建新的`uni-admin`项目（HBuilderX新建项目界面选择uni-admin模板）
2. 在弹出的云服务空间初始化向导中，关联服务空间（如果您的业务App已使用了uniCloud，那么选择相同的服务空间；否则，新建一个服务空间，并在业务App里关联相同服务空间） [uni-admin](https://uniapp.dcloud.io/uniCloud/admin.html)是一个开源管理后台。也就是使用`uni统计2.0`，需要安装这个后台系统，在里面找到uni统计的菜单并使用。
3. 部署云端资源：上传部署云函数、公共模块、通过`db_init.json`初始化数据库表。如之前的表已经有冲突数据，需要自己手动合并下
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#常见问题)。 请参考[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)文档，完成如下操作：
5. 运行 uni-admin 项目，一般是运行到浏览器
6. 设置管理员账户 1. 创建新的`uni-admin`项目（HBuilderX新建项目界面选择uni-admin模板）
7. 在左侧「应用管理」中新增「被统计应用」的记录（appid 等） 2. 在弹出的云服务空间初始化向导中，关联服务空间（如果您的业务App已使用了uniCloud，那么选择相同的服务空间；否则，新建一个服务空间，并在业务App里关联相同服务空间）
8. 配置结束后，启动业务App，将会在运行后的`uni-admin`页面左侧的uni统计菜单里看到业务App的数据（如看不到数据，见下方常见问题章节） 3. 部署云端资源：上传部署云函数、公共模块、通过`db_init.json`初始化数据库表。如之前的表已经有冲突数据，需要自己手动合并下
9. 测试通过后，在HBuilder发行菜单里发行`uni-admin`项目，选择部署到uniCloud服务空间的前端网页托管里。可以在[uniCloud web控制台](https://unicloud.dcloud.net.cn/)自定义域名。 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#常见问题)。
5. 运行 uni-admin 项目，一般是运行到浏览器
6. 设置管理员账户
::: warning 注意 7. 在左侧「应用管理」中新增「被统计应用」的记录（appid 等）
- 「连接本地云函数」运行需要在 uni-admin 的 database 文件夹上右键，点击「下载所有DB schema及扩展校验函数」。如果之前服务空间初始化向导里漏操作了`db_init`初始化数据，则对`uniCloud/database/db_init.json`点右键初始化 8. 配置结束后，启动业务App，将会在运行后的`uni-admin`页面左侧的uni统计菜单里看到业务App的数据（如看不到数据，见下方常见问题章节）
::: 9. 测试通过后，在HBuilder发行菜单里发行`uni-admin`项目，选择部署到uniCloud服务空间的前端网页托管里。可以在[uniCloud web控制台](https://unicloud.dcloud.net.cn/)自定义域名。
**uni-admin老项目升级** ::: warning 注意
- 「连接本地云函数」运行需要在 uni-admin 的 database 文件夹上右键，点击「下载所有DB schema及扩展校验函数」。如果之前服务空间初始化向导里漏操作了`db_init`初始化数据，则对`uniCloud/database/db_init.json`点右键初始化
如您需要统计的业务之前已经使用了`uni-admin`，可以升级`uni-admin`。对项目下的`package.json`点右键，选择「从插件市场更新」。 :::
uni统计新增的文件主要包括：
- 云函数：`uniCloud/cloudfunctions/uni-stat-cron`（定时跑批云函数）、`uniCloud/cloudfunctions/uni-stat-receiver`（接收前端打点的云对象） **uni-admin老项目升级**
- 云函数公共模块：`uniCloud/cloudfunctions/common/uni-stat`
- 数据表：`uniCloud/database`目录下`uni-stat`开头的若干`schema`文件 如您需要统计的业务之前已经使用了`uni-admin`，可以升级`uni-admin`。对项目下的`package.json`点右键，选择「从插件市场更新」。
- 统计页面：`pages/uni-stat` 文件夹下面的若干页面
uni统计新增的文件主要包括：
更新时注意合并pages.json，确保新页面都注册成功。否则运行起来后，点击左侧菜单会报找不到xxx文件。 - 云函数：`uniCloud/cloudfunctions/uni-stat-cron`（定时跑批云函数）、`uniCloud/cloudfunctions/uni-stat-receiver`（接收前端打点的云对象）
- 云函数公共模块：`uniCloud/cloudfunctions/common/uni-stat`
`db_init.json`初始化数据库时，老项目的菜单表`opendb-admin-menus`，已经有数据了，此时key冲突的数据无法插入，需要手工合并。 - 数据表：`uniCloud/database`目录下`uni-stat`开头的若干`schema`文件
1. 如果老项目没有改动过menus和权限，那么可以删掉老表，重新初始化 - 统计页面：`pages/uni-stat` 文件夹下面的若干页面
2. 如果老项目的menus菜单改动过，需要把uni统计的若干页面再合并到菜单数据表里
更新时注意合并pages.json，确保新页面都注册成功。否则运行起来后，点击左侧菜单会报找不到xxx文件。
#### 设置定时任务云函数的触发周期
`db_init.json`初始化数据库时，老项目的菜单表`opendb-admin-menus`，已经有数据了，此时key冲突的数据无法插入，需要手工合并。
`uni统计2.0`中`定时任务云函数（uni-stat-cron）`的默认触发周期为每小时触发一次（即：每隔1小时，系统会自动触发一次`uni-stat-cron`云函数）。 1. 如果老项目没有改动过menus和权限，那么可以删掉老表，重新初始化
2. 如果老项目的menus菜单改动过，需要把uni统计的若干页面再合并到菜单数据表里
你可以根据需要修改`定时任务云函数（uni-stat-cron）`的触发周期到分钟级(即每隔n分钟触发一次)，但要注意触发周期修改后，需要确保[定时任务配置项](#定时任务配置说明)中设置的分钟数是否会被触发，比如你的配置项中设置的是每小时的第10分钟触发（表达式：`* * * 10`），而定时触发器设置的为每20分钟触发1次（`0 1/20 * * * * *`），那这个配置项将永远不会触发。
#### 设置定时任务云函数的触发周期
::: warning 注意
1. 现阶段阿里云仅支持小时级的定时任务（即阿里云云函数的定时触发的最小间隔只能设置为每小时触发一次），因此现阶段阿里云用户如想将`定时任务云函数（uni-stat-cron）`的触发周期设置为分钟级须先向DCloud申请后再开启。[申请方式](https://uniapp.dcloud.io/uniCloud/price.html#aliyun) `uni统计2.0`中`定时任务云函数（uni-stat-cron）`的默认触发周期为每小时触发一次（即：每隔1小时，系统会自动触发一次`uni-stat-cron`云函数）。
2. 因云函数单次最大运行时长为10分钟，所以开启分钟级定时任务后，如果想重新设置定时任务中触发时间的话，最好确保各定时任务之间的触发间隔时间要大于等于10分钟，防止出现运行超时的问题。默认定时任务类型和触发时间可参考下方[定时任务配置说明](#定时任务配置说明)的说明。
::: 你可以根据需要修改`定时任务云函数（uni-stat-cron）`的触发周期到分钟级(即每隔n分钟触发一次)，但要注意触发周期修改后，需要确保[定时任务配置项](#定时任务配置说明)中设置的分钟数是否会被触发，比如你的配置项中设置的是每小时的第10分钟触发（表达式：`* * * 10`），而定时触发器设置的为每20分钟触发1次（`0 1/20 * * * * *`），那这个配置项将永远不会触发。
- 我们这里以将跑批周期修改为每隔10分钟触发1次为例，正确的步骤为： ::: warning 注意
1. 现阶段阿里云仅支持小时级的定时任务（即阿里云云函数的定时触发的最小间隔只能设置为每小时触发一次），因此现阶段阿里云用户如想将`定时任务云函数（uni-stat-cron）`的触发周期设置为分钟级须先向DCloud申请后再开启。[申请方式](https://uniapp.dcloud.io/uniCloud/price.html#aliyun)
1. 修改[uni统计配置项](#公共模块配置项说明)将`cronMin`参数的值改为`true`。 2. 因云函数单次最大运行时长为10分钟，所以开启分钟级定时任务后，如果想重新设置定时任务中触发时间的话，最好确保各定时任务之间的触发间隔时间要大于等于10分钟，防止出现运行超时的问题。默认定时任务类型和触发时间可参考下方[定时任务配置说明](#定时任务配置说明)的说明。
2. 修改`定时任务云函数（uni-stat-cron）`下的`package.json`文件中的定时触发器配置项，关于定时触发器的具体说明可以参考官方文档[定时触发器](https://uniapp.dcloud.io/uniCloud/trigger.html)。 :::
``` javascript
"cloudfunction-config": { - 我们这里以将跑批周期修改为每隔10分钟触发1次为例，正确的步骤为：
"concurrency": 1,
"memorySize": 256, 1. 修改[uni统计配置项](#公共模块配置项说明)将`cronMin`参数的值改为`true`。
"timeout": 600, 2. 修改`定时任务云函数（uni-stat-cron）`下的`package.json`文件中的定时触发器配置项，关于定时触发器的具体说明可以参考官方文档[定时触发器](https://uniapp.dcloud.io/uniCloud/trigger.html)。
"triggers": [ ``` javascript
{ "cloudfunction-config": {
"name": "uni-stat-cron", "concurrency": 1,
"type": "timer", "memorySize": 256,
"config": "0 1/10 * * * * *"//每隔10分钟触发1次的cron表达式，如需复制此项请务必删除该注释 "timeout": 600,
} "triggers": [
] {
} "name": "uni-stat-cron",
``` "type": "timer",
3. 检查配置文件(`config.json`)中的`cron`参数中设置的选项是否会被触发。 "config": "0 1/10 * * * * *"//每隔10分钟触发1次的cron表达式，如需复制此项请务必删除该注释
4. 重新上传部署`定时任务云函数（uni-stat-cron）`和`配置中心（uni-config-center）`。 }
]
}
#### 开启redis缓存 ```
3. 检查配置文件(`config.json`)中的`cron`参数中设置的选项是否会被触发。
开启redis缓存后可以降低数据库查询压力，提升uni统计性能，可按需决定是否开启。 4. 重新上传部署`定时任务云函数（uni-stat-cron）`和`配置中心（uni-config-center）`。
::: warning 注意
开启redis缓存前，需要先确认是否已在布署uni统计的服务空间内购买redis服务，如果没有购买则需要先购买redis服务。 #### 开启redis缓存
:::
开启redis缓存后可以降低数据库查询压力，提升uni统计性能，可按需决定是否开启。
**开启步骤：**
1. 修改[uni统计配置项](#公共模块配置项说明)将`redis`参数的值改为`true`。 ::: warning 注意
2. 分别在数据`上报数据接收器（uni-stat-receiver）`和`定时任务云函数（uni-stat-cron）`下的`package.json`文件中添加redis拓展库。 开启redis缓存前，需要先确认是否已在布署uni统计的服务空间内购买redis服务，如果没有购买则需要先购买redis服务。
3. 重新上传部署数据`上报数据接收器（uni-stat-receiver）`、`定时任务云函数（uni-stat-cron）`和`配置中心（uni-config-center）`。 :::
::: preview **开启步骤：**
> 配置uni-stat-receiver的redis拓展库 1. 修改[uni统计配置项](#公共模块配置项说明)将`redis`参数的值改为`true`。
``` javascript 2. 分别在数据`上报数据接收器（uni-stat-receiver）`和`定时任务云函数（uni-stat-cron）`下的`package.json`文件中添加redis拓展库。
{ 3. 重新上传部署数据`上报数据接收器（uni-stat-receiver）`、`定时任务云函数（uni-stat-cron）`和`配置中心（uni-config-center）`。
"name": "uni-stat-receiver",
"dependencies": { ::: preview
"uni-id": "file:../../../../uni-id/uniCloud/cloudfunctions/common/uni-id", > 配置uni-stat-receiver的redis拓展库
"uni-stat": "file:../common/uni-stat" ``` javascript
}, {
"extensions": { "name": "uni-stat-receiver",
"uni-cloud-jql": {}, "dependencies": {
"uni-cloud-redis": {} // 配置为此云函数开启redis扩展库，值为空对象留作后续追加参数，暂无内容。如拷贝此配置项到package.json文件，切记去除注释。 "uni-id": "file:../../../../uni-id/uniCloud/cloudfunctions/common/uni-id",
} "uni-stat": "file:../common/uni-stat"
} },
``` "extensions": {
> 配置uni-stat-cron的redis拓展库 "uni-cloud-jql": {},
``` javascript "uni-cloud-redis": {} // 配置为此云函数开启redis扩展库，值为空对象留作后续追加参数，暂无内容。如拷贝此配置项到package.json文件，切记去除注释。
{ }
"name": "uni-stat-cron", }
"version": "1.0.0", ```
"description": "", > 配置uni-stat-cron的redis拓展库
"main": "index.js", ``` javascript
"scripts": { {
"test": "echo \"Error: no test specified\" && exit 1" "name": "uni-stat-cron",
}, "version": "1.0.0",
"author": "", "description": "",
"license": "ISC", "main": "index.js",
"dependencies": { "scripts": {
"uni-stat": "file:../common/uni-stat" "test": "echo \"Error: no test specified\" && exit 1"
}, },
"extensions": { "author": "",
"uni-cloud-redis": {} // 配置为此云函数开启redis扩展库，值为空对象留作后续追加参数，暂无内容。如拷贝此配置项到package.json文件，切记去除注释。 "license": "ISC",
}, "dependencies": {
"cloudfunction-config": { "uni-stat": "file:../common/uni-stat"
"concurrency": 1, },
"memorySize": 512, "extensions": {
"timeout": 600, "uni-cloud-redis": {} // 配置为此云函数开启redis扩展库，值为空对象留作后续追加参数，暂无内容。如拷贝此配置项到package.json文件，切记去除注释。
"triggers": [ },
{ "cloudfunction-config": {
"name": "uni-stat-cron", "concurrency": 1,
"type": "timer", "memorySize": 512,
"config": "0 0 * * * * *" "timeout": 600,
} "triggers": [
] {
} "name": "uni-stat-cron",
} "type": "timer",
``` "config": "0 0 * * * * *"
::: }
]
}
### 关联服务空间 }
```
为了让用户端App采集到的数据，可以被`uni-admin`中的云函数正确接收并统计，需保证用户端项目和admin项目，关联同样的服务空间。 :::
1. 选择用户端项目（需采集用户数据的项目）
2. 若该项目之前未启用`uniCloud`，右键并选择 `创建uniCloud云开发环境 -> 阿里云|腾讯云`；否则，进入第3步； ### 关联服务空间
![关联前后台数据](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/b2ad84ed-a69a-43dc-b8d1-6efaafd96a14.png) 为了让用户端App采集到的数据，可以被`uni-admin`中的云函数正确接收并统计，需保证用户端项目和admin项目，关联同样的服务空间。
3. 在`uniCloud`目录右键并选择`关联云服务空间或项目`，在打开的窗口中选择对应`uni-admin`项目关联的服务空间 1. 选择用户端项目（需采集用户数据的项目）
2. 若该项目之前未启用`uniCloud`，右键并选择 `创建uniCloud云开发环境 -> 阿里云|腾讯云`；否则，进入第3步；
![关联前后台数据](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/14744bf3-c88e-4408-b2fa-0ecf0dcf4fe1.png)
![关联前后台数据](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/b2ad84ed-a69a-43dc-b8d1-6efaafd96a14.png)
### 错误解析 <Badge text="uni-admin 1.9.4+" />@sourcemap-parse-error
3. 在`uniCloud`目录右键并选择`关联云服务空间或项目`，在打开的窗口中选择对应`uni-admin`项目关联的服务空间
> 此功能只支持 web平台、App平台、微信小程序平台
![关联前后台数据](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/14744bf3-c88e-4408-b2fa-0ecf0dcf4fe1.png)
为方便开发者使用 sourceMap 文件定位代码问题，增加在统计中使用 sourceMap 错误解析功能。
### 错误解析 <Badge text="uni-admin 1.9.4+" />@sourcemap-parse-error
#### 使用环境@sourcemap-parse-error-env
> 此功能只支持 web平台、App平台、微信小程序平台
1. 使用腾讯云服务空间，不支持阿里云服务空间
2. HBuiderX 3.5.3+ 为方便开发者使用 sourceMap 文件定位代码问题，增加在统计中使用 sourceMap 错误解析功能。
3. uni-admin 1.9.4+
4. 不支持 IE #### 使用环境@sourcemap-parse-error-env
#### 生成 sourceMap@create-sourcemap 1. 使用腾讯云服务空间，不支持阿里云服务空间
2. HBuiderX 3.5.3+
- 在 HBuiderX 中生成 sourceMap 文件 3. uni-admin 1.9.4+
- web 平台在`发行-> 网站`时，勾选 `生成 sourceMap` 选项。 4. 不支持 IE
![web 平台生成 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/c9872cf7-39b1-4c00-9fe6-afc5939b3b31.jpg) #### 生成 sourceMap@create-sourcemap
- App 平台在`发行 -> 原生App-云打包`时，勾选 `生成 sourceMap` 选项。
- 在 HBuiderX 中生成 sourceMap 文件
![app 平台生成 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/5366655c-0ba3-4f5a-b5fc-e80289ed1a17.jpg) - web 平台在`发行-> 网站`时，勾选 `生成 sourceMap` 选项。
- 微信小程序平台在`发行 -> 小程序-微信`时，勾选 `生成 sourceMap` 选项。
![web 平台生成 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/c9872cf7-39b1-4c00-9fe6-afc5939b3b31.jpg)
![微信小程序平台生成 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/85c3eed9-e1b3-41c6-888f-bc1e2cb21a46.jpg) - App 平台在`发行 -> 原生App-云打包`时，勾选 `生成 sourceMap` 选项。
- cli 项目生成 sourceMap 文件 ![app 平台生成 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/5366655c-0ba3-4f5a-b5fc-e80289ed1a17.jpg)
- 微信小程序平台在`发行 -> 小程序-微信`时，勾选 `生成 sourceMap` 选项。
::: preview
![微信小程序平台生成 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/85c3eed9-e1b3-41c6-888f-bc1e2cb21a46.jpg)
> Vue2
```sh - cli 项目生成 sourceMap 文件
yarn build:h5 --sourcemap
::: preview
yarn build:app-plus --sourcemap
> Vue2
yarn build:mp-weixin --sourcemap ```sh
``` yarn build:h5 --sourcemap
> Vue3 yarn build:app-plus --sourcemap
```sh yarn build:mp-weixin --sourcemap
yarn build:h5 --sourcemap ```
yarn build:app --sourcemap > Vue3
yarn build:mp-weixin --sourcemap ```sh
``` yarn build:h5 --sourcemap
::: yarn build:app --sourcemap
1. 项目编译完成后，可在 `/unpackage/dist/build/.sourcemap` 中查看到生成的各平台的 sourceMap 文件。 yarn build:mp-weixin --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 文件 1. 项目编译完成后，可在 `/unpackage/dist/build/.sourcemap` 中查看到生成的各平台的 sourceMap 文件。
2. 将下载好的文件解压到所生成的 .sourcemap 文件夹中： `/unpackage/dist/build/.sourcemap/mp-weixin/__WEIXIN__/`（__WEIXIN__为新建的目录，解析错误时会根据这个名字查找）
![生成的 sourceMap 路径](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/52e1a71d-a6f2-4458-9213-186dd78684de.jpg)
![微信 download sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-a90b5f95-90ba-4d30-a6a7-cd4d057327db/2e4d0e4f-5be6-4a72-adf0-697a576dd3fa.png)
3. 由于微信小程序平台上传发布后，会再压缩打包一次，所以需要额外一个步骤：
**注意事项** 1. 在[微信公众平台](https://mp.weixin.qq.com/)的`开发管理/运维中心/错误日志`中下载线上版本 sourceMap 文件
2. 将下载好的文件解压到所生成的 .sourcemap 文件夹中： `/unpackage/dist/build/.sourcemap/mp-weixin/__WEIXIN__/`（__WEIXIN__为新建的目录，解析错误时会根据这个名字查找）
1. 如果下载的 sourceMap 文件中，只有 `__FULL__` 文件夹，请重命名为 `__APP__`
2. 只支持 `发行模式` sourceMap 文件错误解析 ![微信 download sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-a90b5f95-90ba-4d30-a6a7-cd4d057327db/2e4d0e4f-5be6-4a72-adf0-697a576dd3fa.png)
#### 上传 sourceMap@upload-sourcemap **注意事项**
1. 在 `uni-admin 项目/admin.config.js` 中配置 `uni-stat` 相关信息： 1. 如果下载的 sourceMap 文件中，只有 `__FULL__` 文件夹，请重命名为 `__APP__`
1. 搜索 `uploadSourceMapCloudSpaceId` 补充腾讯云服务空间 SpaceID 2. 只支持 `发行模式` sourceMap 文件错误解析
2. 搜索 `cloudSourceMapUrl` 补充腾讯云云存储访问地址（如：https://xx-xx-xx.tcb.qcloud.la/\_\_UNI\_\_/uni-stat/sourcemap）
#### 上传 sourceMap@upload-sourcemap
![cloudSpaceId](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/f1dee8fc-dfb5-49b1-b905-22f8fa733eca.jpg)
1. 在 `uni-admin 项目/admin.config.js` 中配置 `uni-stat` 相关信息：
2. 将 uni-admin 项目运行到浏览器中，在 `uni 统计 / 错误统计 / js报错` 页面，错误信息列表表格的右上角有 `上传 sourceMap` 按钮。点击后展示如下： 1. 搜索 `uploadSourceMapCloudSpaceId` 补充腾讯云服务空间 SpaceID
2. 搜索 `cloudSourceMapUrl` 补充腾讯云云存储访问地址（如：https://xx-xx-xx.tcb.qcloud.la/\_\_UNI\_\_/uni-stat/sourcemap）
![上传 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-a90b5f95-90ba-4d30-a6a7-cd4d057327db/50878ced-c415-4d8d-923d-f3127e4a1add.png)
![cloudSpaceId](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/f1dee8fc-dfb5-49b1-b905-22f8fa733eca.jpg)
1. 上传请前请填写完整信息：`应用`、`平台`、`版本`
2. 点击 `选择文件并上传` 按钮，弹出 `选择文件夹` 框后，请选中编译的对应该平台版本的 sourceMap。如：**项目根目录/unpackage/dist/build/.sourcemap/h5**，选中 `h5` 目录后点击上传。如果中途上传失败，在不刷新页面的情况下，重新选择文件夹上传可以跳过已上传文件。 2. 将 uni-admin 项目运行到浏览器中，在 `uni 统计 / 错误统计 / js报错` 页面，错误信息列表表格的右上角有 `上传 sourceMap` 按钮。点击后展示如下：
3. 文件夹内容会上传至 `云存储/__UNI__/uni-stat/sourcemap/应用 appId/平台（如：web、mp-weixin、ios）/版本/` 目录下
![上传 sourceMap](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-a90b5f95-90ba-4d30-a6a7-cd4d057327db/50878ced-c415-4d8d-923d-f3127e4a1add.png)
**注意事项**
1. 云存储需要配置权限：`所有用户可读` 1. 上传请前请填写完整信息：`应用`、`平台`、`版本`
2. 如果出现跨域需要在 `跨域配置` 中绑定安全域名 2. 点击 `选择文件并上传` 按钮，弹出 `选择文件夹` 框后，请选中编译的对应该平台版本的 sourceMap。如：**项目根目录/unpackage/dist/build/.sourcemap/h5**，选中 `h5` 目录后点击上传。如果中途上传失败，在不刷新页面的情况下，重新选择文件夹上传可以跳过已上传文件。
3. 上传失败可能会有如下原因： 3. 文件夹内容会上传至 `云存储/__UNI__/uni-stat/sourcemap/应用 appId/平台（如：web、mp-weixin、ios）/版本/` 目录下
1. 如果文件名称、文件夹名称带 `ad` 或者广告类的字段，请关闭浏览器广告拦截扩展再上传
2. 如果云存储中该目录已有同名文件，也可能会上传失败。所以在再次上传相同平台，相同版本的 sourceMap 文件前请将云存储中对应目录 （如：`云存储/__UNI__/uni-stat/sourcemap/应用 appId/平台（如：web、mp-weixin、ios）/版本/`） 删除 **注意事项**
1. 云存储需要配置权限：`所有用户可读`
#### 解析错误@parse-error 2. 如果出现跨域需要在 `跨域配置` 中绑定安全域名
3. 上传失败可能会有如下原因：
在 `uni 统计 / 错误统计 / js报错` 页面，错误信息列表表格中，点击表格行中右侧 `详情按钮` 即可在弹窗中查看解析后错误信息。 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)
![原始错误：](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/1a8f0fcc-9bbf-4563-9c33-ebe4c7e14800.jpg)
- 解析错误是逐行解析，某一行解析失败会返回原错误信息
- `runtime error` 分隔线下方为平台框架运行时错误栈信息，可以不用关心 解析后的错误信息：
## 开源代码解读 ![原始错误：](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/300b16e0-bfea-4dd5-ba95-e06dc1b75b51.jpg)
- 前端采集SDK源码地址，[查看](https://github.com/dcloudio/uni-app/tree/next/packages/uni-stat) - 解析错误是逐行解析，某一行解析失败会返回原错误信息
- 云端统计模块以及统计后台源码地址，[查看](https://github.com/dcloudio/uni-admin) - `runtime error` 分隔线下方为平台框架运行时错误栈信息，可以不用关心
### 前端采集SDK @web-sdk ## 开源代码解读
#### 数据上报逻辑 @report-time
- 前端采集SDK源码地址，[查看](https://github.com/dcloudio/uni-app/tree/next/packages/uni-stat)
数据上报间隔默认是 10s 上报一次 ，在上报间隔内，会将每次上报节点的数据加入统计数据队列，10s后会在下一个上报节点，统一对数据队列进行一定的处理进行上报。 - 云端统计模块以及统计后台源码地址，[查看](https://github.com/dcloudio/uni-admin)
为节约服务端资源，前端采集到的数据按固定周期上报。所以上报请求不是时实发生的。 ### 前端采集SDK @web-sdk
#### 数据上报逻辑 @report-time
`HBuilderX 3.5.4`或更高版本 可以根据自己的业务需求调整上报周期 ，在 `uni统计配置 -> 前端数据上报周期` 中修改即可 ，为节约服务端资源，建议填写范围为 `5-20` 之间。
数据上报间隔默认是 10s 上报一次 ，在上报间隔内，会将每次上报节点的数据加入统计数据队列，10s后会在下一个上报节点，统一对数据队列进行一定的处理进行上报。
::: warning 什么时候会上报数据？
为节约服务端资源，前端采集到的数据按固定周期上报。所以上报请求不是时实发生的。
- 发行代码后，运行项目上报 `（HBuiderX -> 发行 -> 选择开通统计的平台）`
- 运行代码且开启调试模式上报 `（manifest.json -> uniStatistics -> debug:true）` `HBuilderX 3.5.4`或更高版本 可以根据自己的业务需求调整上报周期 ，在 `uni统计配置 -> 前端数据上报周期` 中修改即可 ，为节约服务端资源，建议填写范围为 `5-20` 之间。
除了以上两种情况 ，其他情况都不会发生数据上报,包括 App 真机运行时（含自定义基座），崩溃和错误数据 ::: warning 什么时候会上报数据？
:::
- 发行代码后，运行项目上报 `（HBuiderX -> 发行 -> 选择开通统计的平台）`
- 运行代码且开启调试模式上报 `（manifest.json -> uniStatistics -> debug:true）`
#### 采集类型
除了以上两种情况 ，其他情况都不会发生数据上报,包括 App 真机运行时（含自定义基座），崩溃和错误数据
**应用启动** :::
访问开始即启动程序，访问结束结分为：进入后台超过5min、在前台无任何操作超过30min、新的来源程序
#### 采集类型
|上报字段|说明|
|:-:|:-:| **应用启动**
|lt|统计数据类型，默认值为1，`类型见下文`|
|ut |平台类型，`类型见下文`| 访问开始即启动程序，访问结束结分为：进入后台超过5min、在前台无任何操作超过30min、新的来源程序
|mpsdk|小程序 sdk version|
|mpv|小程序平台版本，如微信、支付宝等| |上报字段|说明|
|mpn|原生平台包名、小程序 appid| |:-:|:-:|
|v|应用版本。原生应用| |lt|统计数据类型，默认值为1，`类型见下文`|
|p|手机系统，`类型见下文`| |ut |平台类型，`类型见下文`|
|net|网络类型，`类型见下文`| |mpsdk|小程序 sdk version|
|brand|手机品牌| |mpv|小程序平台版本，如微信、支付宝等|
|md |手机型号 model| |mpn|原生平台包名、小程序 appid|
|lang|语言| |v|应用版本。原生应用|
|lat|纬度| |p|手机系统，`类型见下文`|
|lng|经度| |net|网络类型，`类型见下文`|
|pr |pixelRatio 设备像素比| |brand|手机品牌|
|ww |windowWidth 可使用窗口宽度| |md |手机型号 model|
|wh |windowHeight 可使用窗口高度| |lang|语言|
|sw |screenWidth 屏幕宽度| |lat|纬度|
|sh |screenHeight 屏幕高度| |lng|经度|
|url|当前页面的完整 url，包含参数在内。最多255字符| |pr |pixelRatio 设备像素比|
|ch |渠道信息| |ww |windowWidth 可使用窗口宽度|
|fvts|首次访问时间戳| |wh |windowHeight 可使用窗口高度|
|lvts|上次访问时间戳| |sw |screenWidth 屏幕宽度|
|cn |国家| |sh |screenHeight 屏幕高度|
|pn |省份| |url|当前页面的完整 url，包含参数在内。最多255字符|
|ct |城市| |ch |渠道信息|
|sc |场景值| |fvts|首次访问时间戳|
|tvc|用户到本次访问为止总共的访问次数| |lvts|上次访问时间戳|
|usv|统计 sdk 版本| |cn |国家|
|t|上报数据时的时间戳| |pn |省份|
|ct |城市|
|sc |场景值|
**应用进入后台** |tvc|用户到本次访问为止总共的访问次数|
|usv|统计 sdk 版本|
应用进入后台时，在 SDK 中是应用的 onHide 生命周期触发 |t|上报数据时的时间戳|
|上报字段|说明|
|:-:|:-:| **应用进入后台**
|lt |统计数据类型，默认值为3，`类型见下文`|
|ut |平台类型，`类型见下文`| 应用进入后台时，在 SDK 中是应用的 onHide 生命周期触发
|p |手机系统，`类型见下文`|
|urlref |应用退出时停留的页面| |上报字段|说明|
|urlref_ts |应用退出时，最后一个页面的停留时间| |:-:|:-:|
|ch |渠道信息| |lt |统计数据类型，默认值为3，`类型见下文`|
|usv |统计 sdk 版本| |ut |平台类型，`类型见下文`|
|t |上报数据时的时间戳| |p |手机系统，`类型见下文`|
|urlref |应用退出时停留的页面|
|urlref_ts |应用退出时，最后一个页面的停留时间|
**页面切换** |ch |渠道信息|
|usv |统计 sdk 版本|
页面跳转时上报，在 SDK 中是页面的 onHide 生命周期触发 |t |上报数据时的时间戳|
|上报字段|说明|
|:-:|:-:| **页面切换**
|lt|统计数据类型，默认值为11，`类型见下文`|
|ut |平台类型，`类型见下文`| 页面跳转时上报，在 SDK 中是页面的 onHide 生命周期触发
|p|手机系统，`类型见下文`|
|url|当前页面的完整 url，包含参数在内。最多255字符| |上报字段|说明|
|ttpj|pages.json 中定义的页面的 title| |:-:|:-:|
|ttn|通过API uni.setnavigationbartitle 设置的 title| |lt|统计数据类型，默认值为11，`类型见下文`|
|ttc|通过 uni.report 上报的页面的 title| |ut |平台类型，`类型见下文`|
|ttct |title 组件中设置的 title| |p|手机系统，`类型见下文`|
|urlref |应用退出时停留的页面| |url|当前页面的完整 url，包含参数在内。最多255字符|
|urlref_ts |应用退出时，最后一个页面的停留时间| |ttpj|pages.json 中定义的页面的 title|
|ch |渠道信息| |ttn|通过API uni.setnavigationbartitle 设置的 title|
|usv|统计 sdk 版本| |ttc|通过 uni.report 上报的页面的 title|
|t|上报数据时的时间戳| |ttct |title 组件中设置的 title|
|urlref |应用退出时停留的页面|
**事件触发** |urlref_ts |应用退出时，最后一个页面的停留时间|
|ch |渠道信息|
用户触发某些业务逻辑时 |usv|统计 sdk 版本|
- 默认事件 |t|上报数据时的时间戳|
- 登录：用户信息
- 支付：商品名称、金额 **事件触发**
- 分享：
- 用户自定义事件 用户触发某些业务逻辑时
- 默认事件
|上报字段|说明| - 登录：用户信息
|:-:|:-:| - 支付：商品名称、金额
|lt|统计数据类型，默认值为21，`类型见下文`| - 分享：
|ut |平台类型，`类型见下文`| - 用户自定义事件
|p|手机系统，`类型见下文`|
|url|当前页面的完整 url，包含参数在内。最多255字符| |上报字段|说明|
|e_n|事件名称| |:-:|:-:|
|e_v|事件参数| |lt|统计数据类型，默认值为21，`类型见下文`|
|ch |渠道信息| |ut |平台类型，`类型见下文`|
|usv|统计 sdk 版本| |p|手机系统，`类型见下文`|
|t|上报数据时的时间戳| |url|当前页面的完整 url，包含参数在内。最多255字符|
|e_n|事件名称|
**应用错误** |e_v|事件参数|
|ch |渠道信息|
应用发生错误时上报 |usv|统计 sdk 版本|
|t|上报数据时的时间戳|
|上报字段|说明|
|:-:|:-:| **应用错误**
|lt|统计数据类型，默认值为21，`类型见下文`|
|ut |平台类型，`类型见下文`| 应用发生错误时上报
|p|手机系统，`类型见下文`|
|ch|渠道信息| |上报字段|说明|
|mpsdk|小程序 SDK Version| |:-:|:-:|
|mpv|小程序平台版本，如微信、支付宝等| |lt|统计数据类型，默认值为21，`类型见下文`|
|v|应用版本。原生应用| |ut |平台类型，`类型见下文`|
|em|错误信息| |p|手机系统，`类型见下文`|
|usv|统计 sdk 版本| |ch|渠道信息|
|t|上报数据时的时间戳| |mpsdk|小程序 SDK Version|
|mpv|小程序平台版本，如微信、支付宝等|
|v|应用版本。原生应用|
**`lt`：统计数据类型** |em|错误信息|
|usv|统计 sdk 版本|
|值|说明| |t|上报数据时的时间戳|
|:-:|:-:|
|1 |应用启动，对应 `onLaunch` 事件|
|3 |应用进入后台，对应应用 `onHide` 事件| **`lt`：统计数据类型**
|11 |页面跳转，对应页面 `onHide` 事件|
|21 |事件触发| |值|说明|
|31 |应用错误| |:-:|:-:|
|1 |应用启动，对应 `onLaunch` 事件|
**`ut`：平台类型** |3 |应用进入后台，对应应用 `onHide` 事件|
|11 |页面跳转，对应页面 `onHide` 事件|
|值|说明| |21 |事件触发|
|:-:|:-:| |31 |应用错误|
|n|移动端 |
|h5|h5 | **`ut`：平台类型**
|wx|微信 |
|ali|阿里 | |值|说明|
|bd|百度 | |:-:|:-:|
|tt|头条 | |n|移动端 |
|qq|qq | |h5|h5 |
|qn|快应用 | |wx|微信 |
|ks|快手 | |ali|阿里 |
|lark|飞书 | |bd|百度 |
|qw|快应用 | |tt|头条 |
|dt| 钉钉 | |qq|qq |
|qn|快应用 |
**`p`：手机系统** |ks|快手 |
|lark|飞书 |
|值|说明| |qw|快应用 |
|:-:|:-:| |dt| 钉钉 |
|a|Android|
|i|iOS| **`p`：手机系统**
|值|说明|
**`net`：网络类型** |:-:|:-:|
|a|Android|
|值|说明| |i|iOS|
|:-:|:-:|
|wifi|wifi网络|
|2g|2g网络| **`net`：网络类型**
|3g|3g网络|
|4g|4g网络| |值|说明|
|5g|5g网络| |:-:|:-:|
|none|无网络| |wifi|wifi网络|
|cable|有线| |2g|2g网络|
|3g|3g网络|
### 云端统计 |4g|4g网络|
|5g|5g网络|
#### 统计报表展示页 |none|无网络|
|cable|有线|
为了突出目标，仅注释出 uni 统计相关的文件夹及文件，其余与普通 uni-app 项目相同。新增页面可参考 uni-stat 中相似页面。
### 云端统计
```bash
├── cloudfunctions #### 统计报表展示页
├── common # 样式
│ │── uni.css # 公共样式 为了突出目标，仅注释出 uni 统计相关的文件夹及文件，其余与普通 uni-app 项目相同。新增页面可参考 uni-stat 中相似页面。
│ └── uni-icons.css # icon样式
├── components # 自定义组件 ```bash
├── js_sdk # js sdk ├── cloudfunctions
│ └── uni-stat # uni统计相关工具方法 ├── common # 样式
│ └── util.js │ │── uni.css # 公共样式
├── pages # 页面 │ └── uni-icons.css # icon样式
│ └── uni-stat # uni统计页面 ├── components # 自定义组件
│ │── channel # 渠道（app） ├── js_sdk # js sdk
│ │ │── channel.vue # 页面（下同） │ └── uni-stat # uni统计相关工具方法
│ │ └── fieldsMap.js # 字段配置（下同） │ └── util.js
│ │── device # 设备统计 ├── pages # 页面
│ │ │── activity # 渠道/场景分析 │ └── uni-stat # uni统计页面
│ │ │ │── activity.vue │ │── channel # 渠道（app）
│ │ │ └── fieldsMap.js │ │ │── channel.vue # 页面（下同）
│ │ │── comparison # 平台对比 │ │ └── fieldsMap.js # 字段配置（下同）
│ │ │ │── comparison.vue │ │── device # 设备统计
│ │ │ └── fieldsMap.js │ │ │── activity # 渠道/场景分析
│ │ │── overview # 今日概览 │ │ │ │── activity.vue
│ │ │ │── overview.vue │ │ │ └── fieldsMap.js
│ │ │ └── fieldsMap.js │ │ │── comparison # 平台对比
│ │ │── retention # 留存 │ │ │ │── comparison.vue
│ │ │ │── retention.vue │ │ │ └── fieldsMap.js
│ │ │ └── fieldsMap.js │ │ │── overview # 今日概览
│ │ │── stickiness # 粘性 │ │ │ │── overview.vue
│ │ │ │── stickiness.vue │ │ │ └── fieldsMap.js
│ │ │ └── fieldsMap.js │ │ │── retention # 留存
│ │ └── trend # 趋势分析 │ │ │ │── retention.vue
│ │ │── trend.vue │ │ │ └── fieldsMap.js
│ │ └── fieldsMap.js │ │ │── stickiness # 粘性
│ │── error # 错误分析 │ │ │ │── stickiness.vue
│ │ │── error.vue │ │ │ └── fieldsMap.js
│ │ └── fieldsMap.js │ │ └── trend # 趋势分析
│ │── event # 事件分析 │ │ │── trend.vue
│ │ │── event.vue │ │ └── fieldsMap.js
│ │ └── fieldsMap.js │ │── error # 错误分析
│ │── index # 统计首页 │ │ │── error.vue
│ │ │── index.vue │ │ └── fieldsMap.js
│ │ └── fieldsMap.js │ │── event # 事件分析
│ │── page-ent # 入口页 │ │ │── event.vue
│ │ │── page-ent.vue │ │ └── fieldsMap.js
│ │ └── fieldsMap.js │ │── index # 统计首页
│ │── page-res # 受访页 │ │ │── index.vue
│ │ │── page-res.vue │ │ └── fieldsMap.js
│ │ └── fieldsMap.js │ │── page-ent # 入口页
│ │── scene # 场景值（小程序） │ │ │── page-ent.vue
│ │ │── scene.vue │ │ └── fieldsMap.js
│ │ └── fieldsMap.js │ │── page-res # 受访页
│ └── user # 用户统计 │ │ │── page-res.vue
│ │── activity # 渠道/场景分析 │ │ └── fieldsMap.js
│ │ │── activity.vue │ │── scene # 场景值（小程序）
│ │ └── fieldsMap.js │ │ │── scene.vue
│ │── comparison # 平台对比 │ │ └── fieldsMap.js
│ │ │── comparison.vue │ └── user # 用户统计
│ │ └── fieldsMap.js │ │── activity # 渠道/场景分析
│ │── overview # 今日概览 │ │ │── activity.vue
│ │ │── overview.vue │ │ └── fieldsMap.js
│ │ └── fieldsMap.js │ │── comparison # 平台对比
│ │── retention # 留存 │ │ │── comparison.vue
│ │ │── retention.vue │ │ └── fieldsMap.js
│ │ └── fieldsMap.js │ │── overview # 今日概览
│ │── stickiness # 粘性 │ │ │── overview.vue
│ │ │── stickiness.vue │ │ └── fieldsMap.js
│ │ └── fieldsMap.js │ │── retention # 留存
│ └── trend # 趋势分析 │ │ │── retention.vue
│ │── trend.vue │ │ └── fieldsMap.js
│ └── fieldsMap.js │ │── stickiness # 粘性
├── static │ │ │── stickiness.vue
├── store │ │ └── fieldsMap.js
├── admin.config.js │ └── trend # 趋势分析
├── App.vue │ │── trend.vue
├── main.js │ └── fieldsMap.js
├── mainfest.json ├── static
├── pages.json ├── store
├── postcss.config.js ├── admin.config.js
└── uni.scss ├── App.vue
``` ├── main.js
├── mainfest.json
├── pages.json
├── postcss.config.js
#### 云函数、通用模块说明 └── uni.scss
```
**一、 uni统计服务端构成**
- `uni-config-center/uni-stat 配置模块`：给uni统计提供运行必要的配置参数。
- `uni-stat 公共模块`：数据处理模块，包括收集上报数据的处理入库及定时任务的数据处理。 #### 云函数、通用模块说明
- `uni-stat-receiver 上报数据接收器`：接收客户端上报数据并转发给公共模块处理。注意：该云对象依赖于`uni-id`公共模块。
- `uni-stat-cron 定时任务云函数`：触发定时任务并转发给公共模块处理。 **一、 uni统计服务端构成**
**二、公共模块说明** - `uni-config-center/uni-stat 配置模块`：给uni统计提供运行必要的配置参数。
- `uni-stat 公共模块`：数据处理模块，包括收集上报数据的处理入库及定时任务的数据处理。
::: warning 注意 - `uni-stat-receiver 上报数据接收器`：接收客户端上报数据并转发给公共模块处理。注意：该云对象依赖于`uni-id`公共模块。
注意：uni统计公共模块依赖于 uniCloud配置中心（uni-config-center） - `uni-stat-cron 定时任务云函数`：触发定时任务并转发给公共模块处理。
:::
**二、公共模块说明**
``` bash
├── shared # 公共模块，提供公共函数库等支持。 ::: warning 注意
│ │── create-api.js # 用来创建对外访问的实例 注意：uni统计公共模块依赖于 uniCloud配置中心（uni-config-center）
│ │── error.js # 错误处理模块 :::
│ │── index.js # 入口文件，提供对外访问的基础模块
│ └── utils.js # 工具函数库文件 ``` bash
├── stat # uni统计实际业务处理模块 ├── shared # 公共模块，提供公共函数库等支持。
│ │── lib # 工具类类库，提供日期计算、数据加密等额外功能支持。 │ │── create-api.js # 用来创建对外访问的实例
│ │ │── date.js # 日期计算类文件 │ │── error.js # 错误处理模块
│ │ │── index.js # 入口文件，提供对外访问模块 │ │── index.js # 入口文件，提供对外访问的基础模块
│ │ └── uni-crypto.js # 数据加密类文件，提供AES/MD5加密 │ └── utils.js # 工具函数库文件
│ │── mod # 数据模型，提供具体业务实现。 ├── stat # uni统计实际业务处理模块
│ │ │── activeDevices.js # 活跃设备模型，给周月维度的设备基础统计和留存统计提供数据，每日跑批合并，仅添加本周/本月首次访问的设备。 │ │── lib # 工具类类库，提供日期计算、数据加密等额外功能支持。
│ │ │── activeUsers.js # 活跃用户模型，给周月维度的用户基础统计和留存统计提供数据，每日跑批合并，仅添加本周/本月首次访问的用户。 │ │ │── date.js # 日期计算类文件
│ │ │── appCrashLogs.js # 原生应用崩溃日志模型，记录原生应用的崩溃日志 │ │ │── index.js # 入口文件，提供对外访问模块
│ │ │── base.js # 基类模型，提供基础服务支持 │ │ └── uni-crypto.js # 数据加密类文件，提供AES/MD5加密
│ │ │── channel.js # 渠道模型，提供渠道和场景值数据 │ │── mod # 数据模型，提供具体业务实现。
│ │ │── errorLog.js # 错误日志模型，记录上报的应用运行错误日志 │ │ │── activeDevices.js # 活跃设备模型，给周月维度的设备基础统计和留存统计提供数据，每日跑批合并，仅添加本周/本月首次访问的设备。
│ │ │── errorResult.js # 错误结果统计模型，统计汇总错误日志中的数据 │ │ │── activeUsers.js # 活跃用户模型，给周月维度的用户基础统计和留存统计提供数据，每日跑批合并，仅添加本周/本月首次访问的用户。
│ │ │── event.js # 事件统计模型，提供应用的事件字典 │ │ │── appCrashLogs.js # 原生应用崩溃日志模型，记录原生应用的崩溃日志
│ │ │── eventLog.js # 事件日志模型，记录上报的事件日志 │ │ │── base.js # 基类模型，提供基础服务支持
│ │ │── eventResult.js # 事件结果统计，统计汇总事件日志中的数据 │ │ │── channel.js # 渠道模型，提供渠道和场景值数据
│ │ │── index.js # 入口文件，提供对外访问模块 │ │ │── errorLog.js # 错误日志模型，记录上报的应用运行错误日志
│ │ │── loyalty.js # 设备/用户忠诚度（粘性）统计模型，统计设备/用户的粘性，粘性判断依据为：访问时长和访问页面数量 │ │ │── errorResult.js # 错误结果统计模型，统计汇总错误日志中的数据
│ │ │── page.js # 页面模型，提供应用的页面字典 │ │ │── event.js # 事件统计模型，提供应用的事件字典
│ │ │── pageLog.js # 页面日志模型，记录上报的页面访问日志 │ │ │── eventLog.js # 事件日志模型，记录上报的事件日志
│ │ │── pageResult.js # 页面结果统计模型，统计汇总页面访问日志中的数据 │ │ │── eventResult.js # 事件结果统计，统计汇总事件日志中的数据
│ │ │── platform.js # 应用平台模型，提供应用的平台字典 │ │ │── index.js # 入口文件，提供对外访问模块
│ │ │── runErrors.js # 运行错误日志，记录数据统计时运行出错的日志 │ │ │── loyalty.js # 设备/用户忠诚度（粘性）统计模型，统计设备/用户的粘性，粘性判断依据为：访问时长和访问页面数量
│ │ │── scenes.js # 场景值模型，提供应用渠道和小程序场景值的数据字典 │ │ │── page.js # 页面模型，提供应用的页面字典
│ │ │── sessionLog.js # 基础会话日志模型，记录设备访问时产生的会话日志 │ │ │── pageLog.js # 页面日志模型，记录上报的页面访问日志
│ │ │── shareLog.js # 分享日志模型，记录触发分享事件的日志 │ │ │── pageResult.js # 页面结果统计模型，统计汇总页面访问日志中的数据
│ │ │── statResult.js # 基础数据结果统计模型，统计汇总会话数据包括不限于设备/用户的数量、访问量、活跃度（日活、周活、月活）、留存率（日留存、周留存、月留存）、跳出率、访问时长等数据 │ │ │── platform.js # 应用平台模型，提供应用的平台字典
│ │ │── uniIDUsers.js # uni-id 用户模型，提供uni-id用户数据查询 │ │ │── runErrors.js # 运行错误日志，记录数据统计时运行出错的日志
│ │ │── userSessionLog.js # 用户会话日志模型，记录登录用户的会话日志 │ │ │── scenes.js # 场景值模型，提供应用渠道和小程序场景值的数据字典
│ │ └── version.js # 应用版本模型，提供应用的版本号字典 │ │ │── sessionLog.js # 基础会话日志模型，记录设备访问时产生的会话日志
│ │── receiver.js # 上报数据接收器，数据上报功能的分发入口文件 │ │ │── shareLog.js # 分享日志模型，记录触发分享事件的日志
│ └── stat.js # 数据统计调度处理模块，数据统计及日志清理功能的分发入口文件 │ │ │── statResult.js # 基础数据结果统计模型，统计汇总会话数据包括不限于设备/用户的数量、访问量、活跃度（日活、周活、月活）、留存率（日留存、周留存、月留存）、跳出率、访问时长等数据
└── index.js # 代理入口文件，提供对外访问的uni-stat对象 │ │ │── uniIDUsers.js # uni-id 用户模型，提供uni-id用户数据查询
``` │ │ │── userSessionLog.js # 用户会话日志模型，记录登录用户的会话日志
│ │ └── version.js # 应用版本模型，提供应用的版本号字典
#### 公共模块配置项说明 │ │── receiver.js # 上报数据接收器，数据上报功能的分发入口文件
uni统计配置项存放于uniCloud配置中心（`uni-config-center`）下的 `uni-stat/config.json`文件中，用户可根据自身系统需要自定义各配置项的值。 │ └── stat.js # 数据统计调度处理模块，数据统计及日志清理功能的分发入口文件
└── index.js # 代理入口文件，提供对外访问的uni-stat对象
::: warning 注意 ```
注意：修改uni统计配置项后需要重新上传公共模块`uni-config-center`后才会生效。
::: #### 公共模块配置项说明
uni统计配置项存放于uniCloud配置中心（`uni-config-center`）下的 `uni-stat/config.json`文件中，用户可根据自身系统需要自定义各配置项的值。
**基础参数**
::: warning 注意
|配置项 |默认值 |说明 | 注意：修改uni统计配置项后需要重新上传公共模块`uni-config-center`后才会生效。
| :--------: |:---------:|:-------------------: | :::
| debug | false |开启调试模式 true: 开启，false:关闭，开启后会产生大量日志，生产环境请关闭。 |
| redis | false |开启redis缓存，开启后可以降低数据库查询压力，提升uni统计性能，可按需决定是否开启。[开启方法](#开启redis缓存) | **基础参数**
| cachetime | 604800 |redis缓存有效期，单位秒。 |
| sessionExpireTime| 1800 |会话过期时间，该配置用来判断当前会话是否已过期，一般情况下无需修改此项。 | |配置项 |默认值 |说明 |
| realtimeStat | true |开启实时统计，true: 开启，false:关闭，开启后会每小时统计一次，数据库读写次数会增多，可按需决定是否开启。 | | :--------: |:---------:|:-------------------: |
| cronMin | false |开启分钟级定时任务，true: 开启，false:关闭。开启后定时任务将细分到分钟级执行，分摊数据计算压力，适合应用日活较大或有特殊需求的用户群体。具体的开启方法见[设置定时任务云函数的触发周期](#设置定时任务云函数的触发周期)。 | | debug | false |开启调试模式 true: 开启，false:关闭，开启后会产生大量日志，生产环境请关闭。 |
| cron | - |用于配置定时任务触发时间，详情见下方[定时任务配置说明](#定时任务配置说明)。 | | redis | false |开启redis缓存，开启后可以降低数据库查询压力，提升uni统计性能，可按需决定是否开启。[开启方法](#开启redis缓存) |
| batchInsertNum | 5000 |当有批量写入操作时，限制单次写入数据库的最大条数。为防止写入超时，最大值为5000条。 | | cachetime | 604800 |redis缓存有效期，单位秒。 |
| errorCheck | - |错误检测，此项用于在规定时间内限制相同的错误日志写入数据库，防止有高频错误产生时造成大量的数据库写入操作。[详情](#错误检测配置说明) | | sessionExpireTime| 1800 |会话过期时间，该配置用来判断当前会话是否已过期，一般情况下无需修改此项。 |
| cleanLog | - |日志清理，此项用于配置定时清理过期的日志，减少数据库数据的存储量，提升uni统计性能。[详情](#日志清理配置说明) | | realtimeStat | true |开启实时统计，true: 开启，false:关闭，开启后会每小时统计一次，数据库读写次数会增多，可按需决定是否开启。 |
| cronMin | false |开启分钟级定时任务，true: 开启，false:关闭。开启后定时任务将细分到分钟级执行，分摊数据计算压力，适合应用日活较大或有特殊需求的用户群体。具体的开启方法见[设置定时任务云函数的触发周期](#设置定时任务云函数的触发周期)。 |
| cron | - |用于配置定时任务触发时间，详情见下方[定时任务配置说明](#定时任务配置说明)。 |
#### 定时任务配置说明 | batchInsertNum | 5000 |当有批量写入操作时，限制单次写入数据库的最大条数。为防止写入超时，最大值为5000条。 |
| errorCheck | - |错误检测，此项用于在规定时间内限制相同的错误日志写入数据库，防止有高频错误产生时造成大量的数据库写入操作。[详情](#错误检测配置说明) |
`cron` 参数用于配置定时任务触发时间，一般无需修改此项。 | cleanLog | - |日志清理，此项用于配置定时清理过期的日志，减少数据库数据的存储量，提升uni统计性能。[详情](#日志清理配置说明) |
|参数 |说明 |
| :--------:|:-------------------: | #### 定时任务配置说明
| type |定时任务类型：如 `stat`：基础数据统计 |
| time |触发时间表达式：`* * * *` 共四位，由左到右分别代表：星期（1-7代表周一到周日）/日/时/分。例：每天晚上0点0分触发，应写作 `* * 0 0` | `cron` 参数用于配置定时任务触发时间，一般无需修改此项。
目前定时任务类型有（`以下括号内的内容表示开启分钟级统计后定时任务的触发时间`）： |参数 |说明 |
| :--------:|:-------------------: |
- `stat`：基础数据统计，统计维度包括： | type |定时任务类型：如 `stat`：基础数据统计 |
- 实时统计，默认`每小时（0分钟）`触发，统计上一小时的基础数据 | time |触发时间表达式：`* * * *` 共四位，由左到右分别代表：星期（1-7代表周一到周日）/日/时/分。例：每天晚上0点0分触发，应写作 `* * 0 0` |
- 日统计，默认`每天上午1点（10分钟）`触发，统计前一天的基础数据
- 周统计，默认`每周一上午1点（20分钟）`触发，统计上一周的基础数据 目前定时任务类型有（`以下括号内的内容表示开启分钟级统计后定时任务的触发时间`）：
- 月统计，默认`每月1号上午3点（30分钟）`触发，统计上一月的基础数据
- `stat`：基础数据统计，统计维度包括：
- `retention-device`：设备留存数据统计，统计维度包括： - 实时统计，默认`每小时（0分钟）`触发，统计上一小时的基础数据
- 日统计，默认`每天上午2点（20分钟）`触发，统计设备日留存数据（初始统计前天到昨天的留存情况，因此需至少运行三天才会有数据） - 日统计，默认`每天上午1点（10分钟）`触发，统计前一天的基础数据
- 周统计，默认`每周一上午2点（30分钟）`触发，统计设备周留存数据（初始统计上上周到上周的留存情况，因此需至少运行三周才会有数据） - 周统计，默认`每周一上午1点（20分钟）`触发，统计上一周的基础数据
- 月统计，默认`每月1号上午4点（30分钟）`触发，统计设备月留存数据（初始统计上上月到上月的留存情况，因此需至少运行三个月才会有数据） - 月统计，默认`每月1号上午3点（30分钟）`触发，统计上一月的基础数据
- `retention-user`：用户留存数据统计，统计维度包括： - `retention-device`：设备留存数据统计，统计维度包括：
- 日统计，默认`每天上午3点（40分钟）`触发，统计用户日留存数据（初始统计前天到昨天的留存情况，因此需至少运行三天才会有数据） - 日统计，默认`每天上午2点（20分钟）`触发，统计设备日留存数据（初始统计前天到昨天的留存情况，因此需至少运行三天才会有数据）
- 周统计，默认`每周一上午5点（30分钟）`触发，统计用户周留存数据（初始统计上上周到上周的留存情况，因此需至少运行三周才会有数据） - 周统计，默认`每周一上午2点（30分钟）`触发，统计设备周留存数据（初始统计上上周到上周的留存情况，因此需至少运行三周才会有数据）
- 月统计，默认`每月1号上午6点（40分钟）`触发，统计用户月留存数据（初始统计上上月到上月的留存情况，因此需至少运行三个月才会有数据） - 月统计，默认`每月1号上午4点（30分钟）`触发，统计设备月留存数据（初始统计上上月到上月的留存情况，因此需至少运行三个月才会有数据）
- `active-device`：活跃设备数据归档，统计维度包括： - `retention-user`：用户留存数据统计，统计维度包括：
- 日归档，默认`每天上午0点（10分钟）`触发，归档前一天的活跃设备数据，注意：此项数据要保持在`基础数据统计`、`设备留存数据统计`、`用户留存数据统计`中的周统计、月统计触发之前执行。 - 日统计，默认`每天上午3点（40分钟）`触发，统计用户日留存数据（初始统计前天到昨天的留存情况，因此需至少运行三天才会有数据）
- 周统计，默认`每周一上午5点（30分钟）`触发，统计用户周留存数据（初始统计上上周到上周的留存情况，因此需至少运行三周才会有数据）
- `active-user`：活跃用户数据归档，统计维度包括： - 月统计，默认`每月1号上午6点（40分钟）`触发，统计用户月留存数据（初始统计上上月到上月的留存情况，因此需至少运行三个月才会有数据）
- 日归档，默认`每天上午0点（20分钟）`触发，归档前一天的活跃用户数据，注意：此项数据要保持在`基础数据统计`、`设备留存数据统计`、`用户留存数据统计`中的周统计、月统计触发之前执行。
- `active-device`：活跃设备数据归档，统计维度包括：
- `page`：页面数据统计，统计维度包括： - 日归档，默认`每天上午0点（10分钟）`触发，归档前一天的活跃设备数据，注意：此项数据要保持在`基础数据统计`、`设备留存数据统计`、`用户留存数据统计`中的周统计、月统计触发之前执行。
- 日统计，默认`每天上午3点（20分钟）`触发，统计前一天的页面数据
- `active-user`：活跃用户数据归档，统计维度包括：
- `event`：事件数据统计，统计维度包括： - 日归档，默认`每天上午0点（20分钟）`触发，归档前一天的活跃用户数据，注意：此项数据要保持在`基础数据统计`、`设备留存数据统计`、`用户留存数据统计`中的周统计、月统计触发之前执行。
- 日统计，默认`每天上午4点（20分钟）`触发，统计前一天的事件数据
- `page`：页面数据统计，统计维度包括：
- `error`：错误数据统计，统计维度包括： - 日统计，默认`每天上午3点（20分钟）`触发，统计前一天的页面数据
- 日统计，默认`每天上午5点（20分钟）`触发，统计前一天的错误数据
- `event`：事件数据统计，统计维度包括：
- `clean`：错误数据统计，统计维度包括： - 日统计，默认`每天上午4点（20分钟）`触发，统计前一天的事件数据
- 日志清理，默认`每天上午5点（30分钟）`触发，清理过期的日志数据
- `error`：错误数据统计，统计维度包括：
- 日统计，默认`每天上午5点（20分钟）`触发，统计前一天的错误数据
#### 错误检测配置说明 - `clean`：错误数据统计，统计维度包括：
- 日志清理，默认`每天上午5点（30分钟）`触发，清理过期的日志数据
`errorCheck`参数用于在规定时间内限制相同的错误日志写入数据库，防止有高频错误产生时造成大量的数据库写入操作，可按需开启或关闭。
|参数 |说明 |
| :--------:|:-------------------: | #### 错误检测配置说明
| needCheck |是否需要检测：true：是；false:否 |
| checkTime |错误检测间隔时间，单位`分钟`。 | `errorCheck`参数用于在规定时间内限制相同的错误日志写入数据库，防止有高频错误产生时造成大量的数据库写入操作，可按需开启或关闭。
|参数 |说明 |
#### 日志清理配置说明 | :--------:|:-------------------: |
| needCheck |是否需要检测：true：是；false:否 |
`cleanLog`参数用于配置定时清理过期的日志，减少数据库数据的存储量，提升uni统计性能。 | checkTime |错误检测间隔时间，单位`分钟`。 |
|参数 |说明 |
| :--------: |:-------------------: | #### 日志清理配置说明
| open |是否开启日志清理：true：是；false:否 |
| reserveDays |各项日志的保留天数配置，参数格式：`日志类型:保留天数`，例如： `sessionLog:31`代表保留31天的会话日志，保留天数设置为0时表示永久保留(此举会累积大量无用数据，不推荐) | `cleanLog`参数用于配置定时清理过期的日志，减少数据库数据的存储量，提升uni统计性能。
目前可配置的日志类型有： |参数 |说明 |
| :--------: |:-------------------: |
- `基础会话日志：sessionLog`，默认保留`31`天的日志。注意：因设备留存统计中最长需要统计30后的留存数据， 所以基础会话日志要至少保存`31`天的日志，否则会对设备留存统计造成影响。 | open |是否开启日志清理：true：是；false:否 |
- `用户会话日志：userSessionLog`，默认保留`31`天的日志。注意：因用户留存统计中最长需要统计30后的留存数据， 所以用户会话日志要至少保存`31`天的日志，否则会对用户留存统计造成影响。 | reserveDays |各项日志的保留天数配置，参数格式：`日志类型:保留天数`，例如： `sessionLog:31`代表保留31天的会话日志，保留天数设置为0时表示永久保留(此举会累积大量无用数据，不推荐) |
- `页面日志：pageLog`，默认保留`7`天的日志。
- `事件日志：eventLog`，默认保留`7`天的日志。 目前可配置的日志类型有：
- `分享日志：shareLog`，默认保留`7`天的日志。
- `错误日志：errorLog`，默认保留`7`天的日志。 - `基础会话日志：sessionLog`，默认保留`31`天的日志。注意：因设备留存统计中最长需要统计30后的留存数据， 所以基础会话日志要至少保存`31`天的日志，否则会对设备留存统计造成影响。
- `用户会话日志：userSessionLog`，默认保留`31`天的日志。注意：因用户留存统计中最长需要统计30后的留存数据， 所以用户会话日志要至少保存`31`天的日志，否则会对用户留存统计造成影响。
::: warning 注意事项 - `页面日志：pageLog`，默认保留`7`天的日志。
- 客户端和统计后台两个项目务必关联同一个服务空间，且uni-admin中所有云函数、公共模板等都已经上传部署到该服务空间 - `事件日志：eventLog`，默认保留`7`天的日志。
- 使用 uni 统计必须配置 APPID 才能正常使用。[DCloud的Appid有什么用，如需转让应用怎么做](https://ask.dcloud.net.cn/article/35907) - `分享日志：shareLog`，默认保留`7`天的日志。
- 应用在运行、调试时不会上报统计数据，仅在发行后，并启动新版的App、h5、小程序，才会上报数据。 - `错误日志：errorLog`，默认保留`7`天的日志。
- 不支持 CLI 项目
::: ::: warning 注意事项
- 客户端和统计后台两个项目务必关联同一个服务空间，且uni-admin中所有云函数、公共模板等都已经上传部署到该服务空间
- 使用 uni 统计必须配置 APPID 才能正常使用。[DCloud的Appid有什么用，如需转让应用怎么做](https://ask.dcloud.net.cn/article/35907)
## 扩展和自定义方式 - 应用在运行、调试时不会上报统计数据，仅在发行后，并启动新版的App、h5、小程序，才会上报数据。
uni统计提供了基础的数据报表，如不能达到预期的数据采集，可以在客户端通过 `uni.report(eventKey,param)` 自由上报数据 ，并通过 uni-admin 增加页面 ，自行统计数据。 - 不支持 CLI 项目
:::
### 前端 uni.report 基础用法
这里列出 `uni.report(eventKey,param)` 的基本用法，完整`API`查看：[详情](https://uniapp.dcloud.io/api/other/report.html) ## 扩展和自定义方式
uni统计提供了基础的数据报表，如不能达到预期的数据采集，可以在客户端通过 `uni.report(eventKey,param)` 自由上报数据 ，并通过 uni-admin 增加页面 ，自行统计数据。
`uni.report(eventKey,param)` 有两个参数。
- eventKey 自定义事件名称 ### 前端 uni.report 基础用法
- param 自定义事件参数
这里列出 `uni.report(eventKey,param)` 的基本用法，完整`API`查看：[详情](https://uniapp.dcloud.io/api/other/report.html)
``` js
// 参数支持字符串 `uni.report(eventKey,param)` 有两个参数。
uni.report('购买','购买成功') - eventKey 自定义事件名称
- param 自定义事件参数
// 参数支持对象
uni.report('购买',{ ``` js
id:'1000', // 参数支持字符串
name:'上衣', uni.report('购买','购买成功')
price:'998',
msg:'购买成功' // 参数支持对象
// ... uni.report('购买',{
}) id:'1000',
``` name:'上衣',
price:'998',
### uni-admin 中使用自定义事件上报的数据 msg:'购买成功'
在 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 ### uni-admin 中使用自定义事件上报的数据
const db = uniCloud.database() 在 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) 表中。
db.collection('uni-stat-event-logs')
``` - 获取数据后，可以自行扩展所需业务逻辑
不管是新上报的数据，还是[opendb](https://uniapp.dcloud.net.cn/uniCloud/opendb.html)的数据、或者开发者自己的业务数据库里的数据，都可以自己编写报表进行统计分析。 ```js
const db = uniCloud.database()
与普通uni-app页面一样，新建页面，编写代码。 db.collection('uni-stat-event-logs')
```
在`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)
不管是新上报的数据，还是[opendb](https://uniapp.dcloud.net.cn/uniCloud/opendb.html)的数据、或者开发者自己的业务数据库里的数据，都可以自己编写报表进行统计分析。
## 版本升级 @upgrade
与普通uni-app页面一样，新建页面，编写代码。
`uni-admin1.9.0`版本开始（对应`HBuilderX 3.5.1`），`uni统计`和`uni升级中心`复用相同的应用版本表（即`opendb-app-versions`表） ，废弃原来的`uni-stat-app-versions`表。
在`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)
如果你已启用`uni统计2.0`，但使用的是老版本的`uni-admin`，则需注意版本表的迁移升级，否则基于版本的统计数据可能不准确。
## 版本升级 @upgrade
升级步骤：
`uni-admin1.9.0`版本开始（对应`HBuilderX 3.5.1`），`uni统计`和`uni升级中心`复用相同的应用版本表（即`opendb-app-versions`表） ，废弃原来的`uni-stat-app-versions`表。
1. 从插件市场更新`uni-admin`项目
2. 上传覆盖`uni-stat`公共模块 如果你已启用`uni统计2.0`，但使用的是老版本的`uni-admin`，则需注意版本表的迁移升级，否则基于版本的统计数据可能不准确。
3. 重新上传覆盖所有的`DB Schema`
4. 将原`uni-stat-app-versions`表中的数据导入到`opendb-app-versions`表中；如下提供了一个代码片段，你可以创建一个云函数，将示例代码拷贝到云函数中，右键执行 “运行-本地云函数”，即可自动完成数据内容的迁移； 升级步骤：
```js 1. 从插件市场更新`uni-admin`项目
'use strict'; 2. 上传覆盖`uni-stat`公共模块
const db = uniCloud.database() 3. 重新上传覆盖所有的`DB Schema`
exports.main = async (event, context) => { 4. 将原`uni-stat-app-versions`表中的数据导入到`opendb-app-versions`表中；如下提供了一个代码片段，你可以创建一个云函数，将示例代码拷贝到云函数中，右键执行 “运行-本地云函数”，即可自动完成数据内容的迁移；
const oldVersionDataRes = await db.collection('uni-stat-app-versions')
.aggregate() ```js
.lookup({ 'use strict';
from: 'uni-stat-app-platforms', const db = uniCloud.database()
localField: 'platform_id', exports.main = async (event, context) => {
foreignField: '_id', const oldVersionDataRes = await db.collection('uni-stat-app-versions')
as: 'platform' .aggregate()
}) .lookup({
.limit(500) from: 'uni-stat-app-platforms',
.end() localField: 'platform_id',
foreignField: '_id',
if (oldVersionDataRes.data.length) { as: 'platform'
for (let oldKey in oldVersionDataRes.data) { })
//老版本表的数据 .limit(500)
const oldVersionData = oldVersionDataRes.data[oldKey] .end()
//组装数据 if (oldVersionDataRes.data.length) {
const newVersionData = { for (let oldKey in oldVersionDataRes.data) {
_id: oldVersionData._id,//_id 两个表数据要保持一致 //老版本表的数据
appid: oldVersionData.appid,//appid const oldVersionData = oldVersionDataRes.data[oldKey]
platform: [],//默认为空数组即可
uni_platform: oldVersionData.platform[0].code,//平台代码 //组装数据
type: 'native_app',//类型 默认为native_app即可 const newVersionData = {
version: oldVersionData.version, _id: oldVersionData._id,//_id 两个表数据要保持一致
create_env: 'uni-stat',//创建来源，设置为uni-stat appid: oldVersionData.appid,//appid
create_date: oldVersionData.create_time//创建时间 platform: [],//默认为空数组即可
} uni_platform: oldVersionData.platform[0].code,//平台代码
await db.collection('opendb-app-versions').add(newVersionData) type: 'native_app',//类型 默认为native_app即可
} version: oldVersionData.version,
} create_env: 'uni-stat',//创建来源，设置为uni-stat
create_date: oldVersionData.create_time//创建时间
return true }
}; await db.collection('opendb-app-versions').add(newVersionData)
``` }
}
## 常见问题
return true
**1. 启动uni统计后，何时可以查看报表数据？** };
```
答：与定时任务配置配置有关，默认`统计首页`、`今日概况`等数据为1小时后可见，其余数据为次日可见。要想详细了解各类型数据统计时间请参考[定时任务配置说明](#定时任务配置说明)。
## 常见问题
**2. 已经开启统计，定时任务配置也正常，但是后台还是看不到数据**
**1. 启动uni统计后，何时可以查看报表数据？**
答：
- 确保分清楚，业务App 和 admin 是2个工程。业务App是采集端，admin是报表端 答：与定时任务配置配置有关，默认`统计首页`、`今日概况`等数据为1小时后可见，其余数据为次日可见。要想详细了解各类型数据统计时间请参考[定时任务配置说明](#定时任务配置说明)。
- 确保使用HBuilderX 3.4.14+。如果是cli创建的项目，需要升级cli到uni-app 3.4.14+
- 确保在需要统计的业务App工程的manifest里勾选了开启 uni统计2.0，并关联和正确的uniCloud服务空间 **2. 已经开启统计，定时任务配置也正常，但是后台还是看不到数据**
- 确保重新发行过业务App（在HBuilder里发行即可，不需要上架应用商店或小程序商店），数据上报只发生在项目发行后或者运行项目开启了调试模式，其他情况不会上报数据。[详情](#report-time)
- 确保`uni-admin`项目的`uniCloud`目录下的云函数都上传到了与App相同的uniCloud服务空间 答：
- 在[uniCloud web控制台](https://unicloud.dcloud.net.cn/)的云函数日志中，可以看到`uni-stat-receiver`云函数有正确的请求日志 - 确保分清楚，业务App 和 admin 是2个工程。业务App是采集端，admin是报表端
- 在[uniCloud web控制台](https://unicloud.dcloud.net.cn/)的云函数日志中，可以看到`uni-stat-cron`云函数有定时执行日志，且日志显示执行成功；如日志中显示`Not Found the cofnig file`，则查看下方第6个问题； - 确保使用HBuilderX 3.4.14+。如果是cli创建的项目，需要升级cli到uni-app 3.4.14+
- 如需看`uni-admin`这个管理端的统计数据，才需要在`uni-admin`工程的`manifest`里配置`uni统计2.0`并再次发行。再次强调不要搞混业务App和admin - 确保在需要统计的业务App工程的manifest里勾选了开启 uni统计2.0，并关联和正确的uniCloud服务空间
- 确保重新发行过业务App（在HBuilder里发行即可，不需要上架应用商店或小程序商店），数据上报只发生在项目发行后或者运行项目开启了调试模式，其他情况不会上报数据。[详情](#report-time)
**3. 如何判断是否需要配置分钟级定时任务？** - 确保`uni-admin`项目的`uniCloud`目录下的云函数都上传到了与App相同的uniCloud服务空间
- 在[uniCloud web控制台](https://unicloud.dcloud.net.cn/)的云函数日志中，可以看到`uni-stat-receiver`云函数有正确的请求日志
答：一般情况下是不需要自行配置的，但如果`定时任务云函数（uni-stat-cron）`出现运行超时的情况时，就要考虑去开启分钟级定时任务了。 - 在[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
**4. 如何创建或授权`uni统计`运营管理员账号**
**3. 如何判断是否需要配置分钟级定时任务？**
答：参考[uni-admin 给系统创建多个登录账户并设置不同的权限](https://uniapp.dcloud.net.cn/uniCloud/admin.html#mutiladmin)
答：一般情况下是不需要自行配置的，但如果`定时任务云函数（uni-stat-cron）`出现运行超时的情况时，就要考虑去开启分钟级定时任务了。
**5. 为什么总设备数比活跃设备数少？**
**4. 如何创建或授权`uni统计`运营管理员账号**
答：总设备数计算公式为：总设备数 = 原设备数 + 新设备数，而判断一个设备是否为新设备的依据是在客户端SDK中是否已储存该设备上次访问某一应用的时间，未存储则认为是该应用的新设备(即lvts=0时为新设备，lvts>0为老设备)。 因此如果之前某一设备已经访问过某一应用，就算此时清除数据库中的数据，由于已经在客户端SDK中储存该设备上次访问应用的时（即此时lvts > 0），所以该设备也不会再被认为是该应用的新设备从而不会再被计算进该应用的总设备数中而只会计算进活跃设备数中，此时可能就会出现总设备数小于活跃设备数的情况。
答：参考[uni-admin 给系统创建多个登录账户并设置不同的权限](https://uniapp.dcloud.net.cn/uniCloud/admin.html#mutiladmin)
**6. uni-stat-cron运行日志显示 Not Found the cofnig file**
**5. 为什么总设备数比活跃设备数少？**
业务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`公共模块即可。 答：总设备数计算公式为：总设备数 = 原设备数 + 新设备数，而判断一个设备是否为新设备的依据是在客户端SDK中是否已储存该设备上次访问某一应用的时间，未存储则认为是该应用的新设备(即lvts=0时为新设备，lvts>0为老设备)。 因此如果之前某一设备已经访问过某一应用，就算此时清除数据库中的数据，由于已经在客户端SDK中储存该设备上次访问应用的时（即此时lvts > 0），所以该设备也不会再被认为是该应用的新设备从而不会再被计算进该应用的总设备数中而只会计算进活跃设备数中，此时可能就会出现总设备数小于活跃设备数的情况。
- 以`uni-admin`为主：将业务App项目下的`uni-config-center`，手动合并配置项到`uni-admin`项目下的`uni-config-center`中（注意：是手动合并配置项，不要整体覆盖文件），然后重新上传`uni-admin`项目下的`uni-config-center`公共模块即可。
**6. uni-stat-cron运行日志显示 Not Found the cofnig file**
## 参考资料
业务App 和 admin 是2个工程。业务App是采集端，admin是报表端；这两个项目均包含`uni-config-center`；如果这两个项目关联（复用）相同的服务空间时，很容易出现`uni-config-center`的互相覆盖问题；此时建议单点维护，方案有2种：
不掌握如下文档，很难对 `uni统计2.0` 吃透和做二次开发 - 以业务App为主：将`uni-admin`项目中`uni-config-center` 下面的`uni-stat`文件夹，复制到业务App项目下的`uni-config-center`目录下，然后重新上传业务App项目下的`uni-config-center`公共模块即可。
- uni-admin文档：[详见](https://uniapp.dcloud.net.cn/uniCloud/admin.html) - 以`uni-admin`为主：将业务App项目下的`uni-config-center`，手动合并配置项到`uni-admin`项目下的`uni-config-center`中（注意：是手动合并配置项，不要整体覆盖文件），然后重新上传`uni-admin`项目下的`uni-config-center`公共模块即可。
- uni-id文档：[详见](https://uniapp.dcloud.net.cn/uniCloud/uni-id.html)
- opendb文档：[详见](https://uniapp.dcloud.net.cn/uniCloud/opendb.html) ## 参考资料
不掌握如下文档，很难对 `uni统计2.0` 吃透和做二次开发
- uni-admin文档：[详见](https://uniapp.dcloud.net.cn/uniCloud/admin.html)
- uni-id文档：[详见](https://uniapp.dcloud.net.cn/uniCloud/uni-id.html)
- opendb文档：[详见](https://uniapp.dcloud.net.cn/uniCloud/opendb.html)
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或