uni统计2.0

uni统计2 是开源、全端、云端一体、更适合uni-app的统计平台。

欢迎加入uni统计2.0技术交流群

demo体验

体验系统：https://hellouniadmin.dcloud.net.cn/

注：uni统计内置在uni-admin中，体验系统的数据会定期重置。

产品特色

无需开发，在manifest的 uni统计 中打勾并发行，在uniCloud服务空间部署uni-admin，即可查看报表。

同时开发者也可以自定义打点数据、自定义展现报表。

1. 全端

全端流量统计，一张报表可查看所有端（iOS、Android、Web 及各家小程序）的运营数据。

无需在各端接不同的sdk、无需在不同报表看数据。目前市面已知唯一一个一张报表看遍业务全景的方案。

2. 开源、免费、自由定制

代码全部开源。采集什么数据可以自定义；跑批频率可以自定义（搞活动时实时统计都可以做到）；展示报表可以自定义。

3. 私有部署、数据自控

使用传统saas类统计产品，所有数据都上报给统计服务厂商。

uni统计2.0基于uniCloud实现，云函数、统计数据全部托管在开发者自己的服务空间（阿里云或腾讯云自选）中，开发者对自己的统计数据拥有完整的控制权。

4. 有效的错误分析

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

uni统计的错误信息更全面，包括 js前端错误和 App 原生层的崩溃。

因为uni-app是编译后运行，传统web和小程序的统计平台，其js报错无法回溯到uni-app的编译前源码，报错看不懂。

uni统计支持sourcemap，可直观了解到底哪行代码写的有问题。详见

5. 默认功能丰富

• 设备统计
• 注册用户统计（基于uni-id）
• 页面统计
• 内容统计
• 新增、活跃、留存、跳出率分析
• 渠道分析：辅助渠道推广
• 错误统计和上报：辅助产品质量提升
• 原生App崩溃统计，分版本查看崩溃率
• 自定义打点、开源可扩展的报表

6. 更适合uni-app和uniCloud

uni统计深入uni-app和uniCloud框架底层，提供了众多其他统计平台无法提供的功能：

• uni-app全端识别，无需对接不同sdk、无需在不同报表中切换和自己累加数据
• 自动识别uni-app路由，自动采集页面标题（基于pages.json的navigationBar或uni-nav-bar组件）
• 自动捕获js错误，上报app端原生崩溃日志
• 兼容uni-app渠道包打包体系，自动识别渠道包
• 基于uni-id账户体系，自动出具注册用户（不是设备）的新增、活跃、留存报表
• 兼容uniCloud opendb规范，从服务器端统计各项数据

7. 开放生态

uni统计的开源且基于uni-admin的插件规范提供了插件机制，会有更多插件作者提供各种丰富的统计插件（如电商统计、内容统计等）。见插件市场

DCloud非常重视数据驱动开发者业务的增长，近期联合专业的大数据服务商神策和阿拉丁共同完善Uni统计2.0的产品模块和生态建设。 如果你对数据分析有任何需求，欢迎您填写需求调研问卷，我们会根据您的宝贵建议，在原有Uni统计产品的基础上，完成迭代更新。

uni 统计老版升级建议

对于使用uni统计1.0的开发者，推荐尽快升级到uni统计2.0。uni统计1.0将不再更新维护。

功能	uni统计1.0	uni统计2.0
是否开源	否	是
部署方式	中央部署	私有部署
定制方式	不可定制	自由定制
uni-id用户统计	不含	默认包含
错误分析有效性	较低	较高

环境要求

• uni统计2.0 在客户端仅支持uni-app，非uni-app无法使用。
• uni统计2.0 在云端虽然依赖uniCloud，但并不要求开发者的应用全部基于uniCloud开发。应用的主业务可以连接传统服务器，统计打点、报表展现使用uniCloud即可。

使用教程

uni统计2.0包括两个模块：

• 前端采集模块：内置在uni-app框架中，在业务App的manifest.json进行配置；
• 云端统计模块：内置在uni-admin项目模板中，和业务App复用同样的uniCloud服务空间；

前端采集配置

在业务App项目的 manifest.json 里，选择 uni统计配置 项，根据需求，选择开通 uni统计 ，勾选 2.0 开启新版统计。

上述可视化操作，其实对应manifest源码视图的 uniStatistics 节点。如下文档对manifest规范进行详述。如不关心规范细节，可以不阅读本小节，继续看下一节《小程序域名白名单》。

uniStatistics 下的 enable 字段设置为 true|false，来开启关闭 uni统计

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

//...
"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	开启统计调试模式 ，会产生大量日志，且会在开发阶段上报数据，应用发布请关闭此项
reportInterval	Number	10	-	前端数据上报周期 HBuilderX 3.5.4+ 支持
collectItems	Object	-	-	采集项配置 HBuilderX 3.5.5+ 支持

collectItems 采集项配置说明

字段	类型	默认值	可选值	说明
uniPushClientID	Boolean	false	true/false	是否开启推送PushClientID的采集
uniStatPageLog	Boolean	true	true/false	是否开启页面数据采集，

分平台设置

uniStatistics 支持分平台设置，比如仅开启微信小程序平台的 uni统计，则在 manifest.json mp-weixin节点下设置 uniStatistics ->enable 即可，如下：

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

分平台uniStatistics说明

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

注意

• 在分平台下如有uniStatistics -> enable字段，则优先使用分平台下配置 ，反之使用全局统计设置
• 分平台无需设置 version、debug 属性 ，两个属性仅全局生效
• 分平台无需设置 debug 属性 ，该属性仅在全局生效
• 仅在开启调试模式或发行代码后才会正常上报数据

小程序域名白名单

由于各家小程序对可访问的域名要配置白名单，否则无法联网。所以需要发布小程序时需要在各厂商的小程序管理后台配置域名白名单。

部署uni统计时可以选择使用uniCloud的阿里云版或腾讯云版，不同云厂商对应的域名不同（文章后面章节会有服务空间相关配置）

点击查看各厂商request合法域名。

根据选择的uniCloud云厂商，配置相应的域名到小程序的域名白名单配置里即可。

注意

• 阿里云迁移正式版后未重新发布的项目仍会访问公测版地址api.bspapp.com

调试模式

将 manifest.json -> uniStatistics 下的 debug 字段设置为 true|false ，来开启关闭 uni统计调试模式

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

日志格式

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

// 标识统计开启
=== 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

后台报表配置

创建 admin 项目

uni统计2.0的后台统计报表是uni-admin的内置插件。

uni-admin是一个开源管理后台。也就是使用uni统计2.0，需要安装这个后台系统，在里面找到uni统计的菜单并使用。

目前安装uni-admin的方式分为两种：一键部署 和 手动安装。

一键部署uni-admin仅需要前往插件市场搜索找到uni-admin插件后，选择进入uni-admin插件详情页并点击一键部署插件到uniCloud按钮，然后选择需要部署uni-admin项目的服务空间后耐心等待系统自动部署完成即可。

手动安装uni-admin则请参考uni-admin文档，完成如下操作：

1. 创建新的uni-admin项目（HBuilderX新建项目界面选择uni-admin模板）
2. 在弹出的云服务空间初始化向导中，关联服务空间（如果您的业务App已使用了uniCloud，那么选择相同的服务空间；否则，新建一个服务空间，并在业务App里关联相同服务空间）
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的相互覆盖问题，此时建议单点维护，详见。
5. 运行 uni-admin 项目，一般是运行到浏览器
6. 设置管理员账户
7. 在左侧「应用管理」中新增「被统计应用」的记录（appid 等）
8. 配置结束后，启动业务App，将会在运行后的uni-admin页面左侧的uni统计菜单里看到业务App的数据（如看不到数据，见下方常见问题章节）
9. 测试通过后，在HBuilder发行菜单里发行uni-admin项目，选择部署到uniCloud服务空间的前端网页托管里。可以在uniCloud web控制台自定义域名。

注意

• 「连接本地云函数」运行需要在 uni-admin 的 database 文件夹上右键，点击「下载所有DB schema及扩展校验函数」。如果之前服务空间初始化向导里漏操作了db_init初始化数据，则对uniCloud/database/db_init.json点右键初始化

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文件。

db_init.json初始化数据库时，老项目的菜单表opendb-admin-menus，已经有数据了，此时key冲突的数据无法插入，需要手工合并。

1. 如果老项目没有改动过menus和权限，那么可以删掉老表，重新初始化
2. 如果老项目的menus菜单改动过，需要把uni统计的若干页面再合并到菜单数据表里

设置定时任务云函数的触发周期

uni统计2.0中定时任务云函数（uni-stat-cron）的默认触发周期为每小时触发一次（即：每隔1小时，系统会自动触发一次uni-stat-cron云函数）。

你可以根据需要修改定时任务云函数（uni-stat-cron）的触发周期到分钟级(即每隔n分钟触发一次)，但要注意触发周期修改后，需要确保定时任务配置项中设置的分钟数是否会被触发，比如你的配置项中设置的是每小时的第10分钟触发（表达式：* * * 10），而定时触发器设置的为每20分钟触发1次（0 1/20 * * * * *），那这个配置项将永远不会触发。

注意

1. 阿里云正式版最低触发间隔为1分钟，支付宝云与腾讯云最低触发间隔为1秒
2. 因云函数单次最大运行时长为10分钟，所以开启分钟级定时任务后，如果想重新设置定时任务中触发时间的话，最好确保各定时任务之间的触发间隔时间要大于等于10分钟，防止出现运行超时的问题。默认定时任务类型和触发时间可参考下方定时任务配置说明的说明。

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

1. 修改uni统计配置项将cronMin参数的值改为true。
2. 修改定时任务云函数（uni-stat-cron）下的package.json文件中的定时触发器配置项，关于定时触发器的具体说明可以参考官方文档定时触发器。

"cloudfunction-config": {
	"concurrency": 1,
	"memorySize": 256,
	"timeout": 600,
	"triggers": [
		{
			"name": "uni-stat-cron",
			"type": "timer",
			"config": "0 */10 * * * * *"//每隔10分钟触发1次的cron表达式，如需复制此项请务必删除该注释
		}
	]
}

3. 检查配置文件(config.json)中的cron参数中设置的选项是否会被触发。
4. 重新上传部署定时任务云函数（uni-stat-cron）和配置中心（uni-config-center）。

开启redis缓存

开启redis缓存后可以降低数据库查询压力，提升uni统计性能，可按需决定是否开启。

注意

开启redis缓存前，需要先确认是否已在布署uni统计的服务空间内购买redis服务，如果没有购买则需要先购买redis服务。

开启步骤：

1. 修改uni统计配置项将redis参数的值改为true。
2. 分别在数据上报数据接收器（uni-stat-receiver）和定时任务云函数（uni-stat-cron）下的package.json文件中添加redis拓展库。
3. 重新上传部署数据上报数据接收器（uni-stat-receiver）、定时任务云函数（uni-stat-cron）和配置中心（uni-config-center）。

配置uni-stat-receiver的redis拓展库

配置uni-stat-cron的redis拓展库

{
	"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文件，切记去除注释。
	}
}

关联服务空间

为了让用户端App采集到的数据，可以被uni-admin中的云函数正确接收并统计，需保证用户端项目和admin项目，关联同样的服务空间。

1. 选择用户端项目（需采集用户数据的项目）
2. 若该项目之前未启用uniCloud，右键并选择 创建uniCloud云开发环境 -> 支付宝云|阿里云|腾讯云（数据量大推荐使用支付宝云）；否则，进入第3步；

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

错误解析 uni-admin 1.9.4+

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

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

使用环境

1. 腾讯云服务空间（uni-admin 1.9.4+），阿里云服务空间（uni-admin 2.3.4+），支付宝云服务空间（uni-admin 2.4.3+）
2. HBuiderX 3.5.3+
3. 不支持 IE，不支持hbx内置浏览器，推荐使用谷歌浏览器

生成 sourceMap

线上运行端在各种用户环境下可能会有报错，需要开发者统计和分析。但三方统计系统（如友盟、阿拉丁、百度），对运行端的报错采集，提示的是uni-app编译器编译后的代码报错的行数，相当于乱码，无法告知开发者是uni-app的vue或js的哪一行代码报错。

uni统计的sourceMap功能可以解决这一问题，在统计后台可以清晰的看到报错的环境和准确的报错代码，是uni-app编译前的vue或js的具体信息。

• 在 HBuiderX 中生成 sourceMap 文件

  • web 平台在发行-> 网站时，勾选 生成 sourceMap 选项。

    

  • App 平台在发行 -> 原生App-云打包时，勾选 生成 sourceMap 选项。

    

  • 微信小程序平台在发行 -> 小程序-微信时，勾选 生成 sourceMap 选项。

    

• cli 项目生成 sourceMap 文件

  Vue2

  Vue3

  yarn build:h5 --sourcemap
  
  yarn build:app-plus --sourcemap
  
  yarn build:mp-weixin --sourcemap
  

1. 项目编译完成后，可在 /unpackage/dist/build/.sourcemap 中查看到生成的各平台的 sourceMap 文件。

   

2. 由于微信小程序平台上传发布后，会再压缩打包一次，所以需要额外一个步骤：

   1. 在微信公众平台的开发管理/运维中心/错误日志中下载线上版本 sourceMap 文件
   2. 将下载好的文件解压到所生成的 .sourcemap 文件夹中： /unpackage/dist/build/.sourcemap/mp-weixin/__WEIXIN__/（__WEIXIN__为新建的目录，解析错误时会根据这个名字查找）

   

   注意事项

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

上传 sourceMap

uni-admin 2.3.4+ 版本

注意：2.3.4+ 的版本同时支持阿里云和腾讯云空间。

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

   

2. 上传请前请填写完整信息：应用、平台、版本

3. 点击 选择文件并上传 按钮，弹出 选择文件夹 框后，请选中编译的对应该平台版本的 sourceMap。如：项目根目录/unpackage/dist/build/.sourcemap/h5，选中 h5 目录后点击上传。如果中途上传失败，在不刷新页面的情况下，重新选择文件夹上传可以跳过已上传文件。

4. 上传完成

uni-admin 2.3.4 之前的版本

注意：2.3.4 之前的版本只支持腾讯云空间，不支持阿里云空间。

1. 在 uni-admin 项目/admin.config.js 中配置 uni-stat 相关信息：

   1. 搜索 uploadSourceMapCloudSpaceId 补充腾讯云服务空间 SpaceID
   2. 搜索 cloudSourceMapUrl 补充腾讯云云存储访问地址（如：https://xx-xx-xx.tcb.qcloud.la/__UNI__/uni-stat/sourcemap）

   

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

   

3. 上传请前请填写完整信息：应用、平台、版本

4. 点击 选择文件并上传 按钮，弹出 选择文件夹 框后，请选中编译的对应该平台版本的 sourceMap。如：项目根目录/unpackage/dist/build/.sourcemap/h5，选中 h5 目录后点击上传。如果中途上传失败，在不刷新页面的情况下，重新选择文件夹上传可以跳过已上传文件。

5. 文件夹内容会上传至 云存储/__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）/版本/） 删除

解析错误

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

示例

原始错误信息：

解析后的错误信息：

• 解析错误是逐行解析，某一行解析失败会返回原错误信息
• runtime error 分隔线下方为平台框架运行时错误栈信息，可以不用关心

开源代码解读

• 前端采集SDK源码地址，查看
• 云端统计模块以及统计后台源码地址，查看

前端采集SDK

数据上报逻辑

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

为节约服务端资源，前端采集到的数据按固定周期上报。所以上报请求不是时实发生的。

HBuilderX 3.5.4或更高版本 可以根据自己的业务需求调整上报周期 ，在 uni统计配置 -> 前端数据上报周期 中修改即可 ，为节约服务端资源，建议填写范围为 5-20 之间。

什么时候会上报数据？

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

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

采集类型

应用启动

访问开始即启动程序，访问结束结分为：进入后台超过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：平台类型

值	说明
n	移动端
h5	h5
wx	微信
ali	阿里
bd	百度
tt	头条
qq	qq
qn	快应用
ks	快手
lark	飞书
qw	快应用
dt	钉钉

p：手机系统

值	说明
a	Android
i	iOS

net：网络类型

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

云端统计

统计报表展示页

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

├── 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
│       │── page-content                # 内容统计
│       │   │── page-content.vue
│       │   └── fieldsMap.js
│       │── page-rule                   # 页面规则
│       │   │── page-rule.vue
│       │── pay-order                   # 支付统计
│           │── funnel                  # 支付/漏斗分析
│           │   │── funnel.vue
│           │   └── fieldsMap.js
│           │── list                    # 支付/订单明细
│           │   │── list.vue
│           │── overview                # 支付/订单概况
│           │   │── overview.vue
│           │   └── fieldsMap.js
│           └── ranking                 # 支付/用户价值排行
│               └── ranking.vue
│       │── 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

云函数、通用模块说明

一、 uni统计服务端构成

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

二、公共模块说明

注意

注意：uni统计公共模块依赖于 uniCloud配置中心（uni-config-center）

├── shared                              # 公共模块，提供公共函数库等支持。
│   │── create-api.js                   # 用来创建对外访问的实例
│   │── error.js                   		# 错误处理模块
│   │── index.js                   		# 入口文件，提供对外访问的基础模块
│   └── utils.js                     	# 工具函数库文件
├── stat                                # uni统计实际业务处理模块
│   │── lib                             # 工具类类库，提供日期计算、数据加密等额外功能支持。
│   │   │── date.js                     # 日期计算类文件
│   │   │── index.js                    # 入口文件，提供对外访问模块
│   │   └── uni-crypto.js               # 数据加密类文件，提供AES/MD5加密
│   │── mod                             # 数据模型，提供具体业务实现。
│   │   │── uni-pay                     # 支付统计目录
│   │   │   └── payResult.js            # 支付统计模型，跑批支付统计数据。
│   │   │── activeDevices.js            # 活跃设备模型，给周月维度的设备基础统计和留存统计提供数据，每日跑批合并，仅添加本周/本月首次访问的设备。
│   │   │── activeUsers.js              # 活跃用户模型，给周月维度的用户基础统计和留存统计提供数据，每日跑批合并，仅添加本周/本月首次访问的用户。
│   │   │── appCrashLogs.js             # 原生应用崩溃日志模型，记录原生应用的崩溃日志
│   │   │── base.js                     # 基类模型，提供基础服务支持
│   │   │── channel.js                  # 渠道模型，提供渠道和场景值数据
│   │   │── errorLog.js                 # 错误日志模型，记录上报的应用运行错误日志
│   │   │── errorResult.js              # 错误结果统计模型，统计汇总错误日志中的数据
│   │   │── event.js                    # 事件统计模型，提供应用的事件字典
│   │   │── eventLog.js                 # 事件日志模型，记录上报的事件日志
│   │   │── eventResult.js              # 事件结果统计，统计汇总事件日志中的数据
│   │   │── index.js                    # 入口文件，提供对外访问模块
│   │   │── loyalty.js                  # 设备/用户忠诚度（粘性）统计模型，统计设备/用户的粘性，粘性判断依据为：访问时长和访问页面数量
│   │   │── page.js                     # 页面模型，提供应用的页面字典
│   │   │── pageDetail.js               # 页面内容模型，提供页面规则匹配到的页面详情字典
│   │   │── pageDetailResult.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                  # 应用版本模型，提供应用的版本号字典
│   │── receiver.js                     # 上报数据接收器，数据上报功能的分发入口文件
│   └── stat.js                         # 数据统计调度处理模块，数据统计及日志清理功能的分发入口文件
└── index.js                            # 代理入口文件，提供对外访问的uni-stat对象

公共模块配置项说明

uni统计配置项存放于uniCloud配置中心（uni-config-center）下的 uni-stat/config.json文件中，用户可根据自身系统需要自定义各配置项的值。

注意

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

基础参数

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

定时任务配置说明

cron 参数用于配置定时任务触发时间，一般无需修改此项。

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

目前定时任务类型有（以下括号内的内容表示开启分钟级统计后定时任务的触发时间）：

• stat：基础数据统计，统计维度包括：

  • 实时统计，默认每小时（0分钟）触发，统计上一小时的基础数据
  • 日统计，默认每天上午1点（10分钟）触发，统计前一天的基础数据
  • 周统计，默认每周一上午1点（20分钟）触发，统计上一周的基础数据
  • 月统计，默认每月1号上午3点（30分钟）触发，统计上一月的基础数据

• retention-device：设备留存数据统计，统计维度包括：

  • 日统计，默认每天上午2点（20分钟）触发，统计设备日留存数据（初始统计前天到昨天的留存情况，因此需至少运行三天才会有数据）
  • 周统计，默认每周一上午2点（30分钟）触发，统计设备周留存数据（初始统计上上周到上周的留存情况，因此需至少运行三周才会有数据）
  • 月统计，默认每月1号上午4点（30分钟）触发，统计设备月留存数据（初始统计上上月到上月的留存情况，因此需至少运行三个月才会有数据）

• retention-user：用户留存数据统计，统计维度包括：

  • 日统计，默认每天上午3点（40分钟）触发，统计用户日留存数据（初始统计前天到昨天的留存情况，因此需至少运行三天才会有数据）
  • 周统计，默认每周一上午5点（30分钟）触发，统计用户周留存数据（初始统计上上周到上周的留存情况，因此需至少运行三周才会有数据）
  • 月统计，默认每月1号上午6点（40分钟）触发，统计用户月留存数据（初始统计上上月到上月的留存情况，因此需至少运行三个月才会有数据）

• active-device：活跃设备数据归档，统计维度包括：

  • 日归档，默认每天上午0点（10分钟）触发，归档前一天的活跃设备数据，注意：此项数据要保持在基础数据统计、设备留存数据统计、用户留存数据统计中的周统计、月统计触发之前执行。

• active-user：活跃用户数据归档，统计维度包括：

  • 日归档，默认每天上午0点（20分钟）触发，归档前一天的活跃用户数据，注意：此项数据要保持在基础数据统计、设备留存数据统计、用户留存数据统计中的周统计、月统计触发之前执行。

• page：页面数据统计，统计维度包括：

  • 日统计，默认每天上午3点（20分钟）触发，统计前一天的页面数据

• page-detail：页面内容统计，统计维度包括：

  • 日统计，默认每天上午7点（10分钟）触发，统计前一天的页面内容数据

• event：事件数据统计，统计维度包括：

  • 日统计，默认每天上午4点（20分钟）触发，统计前一天的事件数据

• error：错误数据统计，统计维度包括：

  • 日统计，默认每天上午5点（20分钟）触发，统计前一天的错误数据

• clean：过期日志清理定时任务：

  • 日志清理，默认每天上午5点（30分钟）触发，清理过期的日志数据

• pay-result：支付数据结果统计，统计维度包括：

  • 实时统计，默认每小时（10分钟）触发，统计上一小时的基础数据（实时统计时，会自动统计小时、天、周、月、季度、年度维度的数据，无需再配置其他维度统计）

错误检测配置说明

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天的日志。
• 实时统计数据：resultHourLog，默认保留30天的日志。
• app崩溃日志：appCrashLog，默认保留7天的日志。

注意事项

• 客户端和统计后台两个项目务必关联同一个服务空间，且uni-admin中所有云函数、公共模板等都已经上传部署到该服务空间
• 使用 uni 统计必须配置 APPID 才能正常使用。DCloud的Appid有什么用，如需转让应用怎么做
• 应用在运行、调试时不会上报统计数据，仅在发行后，并启动新版的App、h5、小程序，才会上报数据。
• 不支持 CLI 项目

扩展和自定义方式

uni统计提供了基础的数据报表，如不能达到预期的数据采集，可以在客户端通过 uni.report(eventKey,param) 自由上报数据 ，并通过 uni-admin 增加页面 ，自行统计数据。

前端 uni.report 基础用法

这里列出 uni.report(eventKey,param) 的基本用法，完整API查看：详情

uni.report(eventKey,param) 有两个参数。

• eventKey 自定义事件名称
• param 自定义事件参数

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

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

uni-admin 中使用自定义事件上报的数据

在 uni-admin 中新增页面，使用 uniCloud API 获取所有 uni-report 上报的原始数据，数据存放于 uni-stat-event-logs 表中。

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

const db = uniCloud.database()
db.collection('uni-stat-event-logs')

不管是新上报的数据，还是opendb的数据、或者开发者自己的业务数据库里的数据，都可以自己编写报表进行统计分析。

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

在uni-admin中注册左侧菜单时，需要参考文档：uni-admin 左侧窗口-菜单栏

版本升级

升级到1.9.0+ 版本

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
};

升级到2.4.0+ 含内容统计的版本

uni-admin2.4.0 版本开始，新增了内容统计，可以通过设置页面规则进行内容统计。内容统计模块默认处于关闭状态，开启内容统计后会增加大量的数据库读写次数，请按需开启。开启内容统计的方式，可参考公共模块配置项说明。

演示图

内容统计

页面规则

设置页面规则

注意

如果升级uni-admin后，你的uni统计没有出现内容统计的菜单，则点击菜单管理里的【更新内置菜单】按钮即可（需uni-admin版本>=2.4.0）

升级到2.4.24+ 含鸿蒙平台的版本

uni-admin2.4.24 版本开始，新增了对App-Harmony（即鸿蒙App）平台的统计。

若您部署过uni-admin2.4.24之前的版本，需要先将uni-admin升级到2.4.24之后的版本。

升级uni-admin项目的方法

1. 通过HBuilderX部署uni-admin项目的用户，可直接在HBuilerX 中，找到uni-admin项目根目录/package.json文件，右键 => 从插件市场更新，合并项目文件后重新打包、发布uni-admin项目即可。

注意

• 若之前自行修改过uni-admin项目，需要手动合并处理，否则修改的内容可能会被覆盖。

2. 通过插件市场在线部署功能，部署uni-admin项目的用户，可重新在插件市场选择在线部署，注意appid需要与原uni-admin项目的AppId保持一致，否则将会导致管理员账号无法登录，原uni-admin项目的AppId，可在插件市场的插件部署记录模块查看。

在uni-admin项目中添加App-Harmony服务平台

如果您在uni-admin项目中，无法找到App-Harmony平台，您需要在HBuilderX中，找到uni-admin项目根目录/uniCloud/database/JQL查询.jql文件，添加以下jql语句并运行。

注意

• 通过插件市场在线部署功能，部署uni-admin项目的用户，需要先在HBuilderX中创建uni-admin项目，并关联原部署uni-admin项目服务空间，再进行如上操作。

db.collection('uni-stat-app-platforms').add({
	"name": "App-Harmony",
	"code": "harmony",
	"order": 2,
	"enable": true,
	"create_time": 1730886932506
})

升级HBuilderX至4.33+，重新打包、发布您要统计的应用

uni-admin项目更新后，即可正常接收和统计App-Harmony平台的相关数据。此外，您还需要升级uni统计2.0的前端采集SDK，采集数据才能正常上报，即需要将HBuilderX版本升级至4.33+后，重新打包发布您要统计的应用。

升级到2.4.25+ 含鸿蒙元服务平台的版本

uni-admin2.4.25 版本开始，新增了对鸿蒙元服务平台的统计。

若您部署过uni-admin2.4.25之前的版本，需要先将uni-admin升级到2.4.25之后的版本，升级uni-admin项目的方法，可参考上方升级到2.4.24+ 含鸿蒙平台的版本中的说明。

在uni-admin项目中添加鸿蒙元服务平台

如果您在uni-admin项目中，无法找到鸿蒙元服务平台，您需要在HBuilderX中，找到uni-admin项目根目录/uniCloud/database/JQL查询.jql文件，添加以下jql语句并运行。

注意

• 通过插件市场在线部署功能，部署uni-admin项目的用户，需要先在HBuilderX中创建uni-admin项目，并关联原部署uni-admin项目服务空间，再进行如上操作。

db.collection('uni-stat-app-platforms').add({
    "name":"鸿蒙元服务",
    "code":"mp-harmony",
    "order":16,
    "enable":true,
    "create_time":163998979103
})

升级HBuilderX至4.33+，重新打包、发布您要统计的应用

uni-admin项目更新后，即可正常接收和统计鸿蒙元服务平台的相关数据。此外，您还需要升级uni统计2.0的前端采集SDK，采集数据才能正常上报，即需要将HBuilderX版本升级至4.33+后，重新打包发布您要统计的应用。

uni统计2.0费用评测

前言

近期，uniCloud阿里云版开始正式商用，部分开发者对基于uniCloud的uni统计等云端一体业务，开始纠结，不清楚这些业务预计会花费多少钱，不清楚相比传统服务器而言，何种方案性价比更好。

本文尝试算细账、算总账，以阿里云按量计费为例，详细预测uni统计在不同用户规模下的资源消耗及对应费用，帮助大家明智选择，无忧开发。

本文主要分为三个部分：

• uni统计消耗的资源费用测算
• uni统计给你带来的收益
• 综合考虑，你该如何选择

uni统计 消耗的资源费用测算

uni统计涉及费用的部分主要分为：

• 云函数：uni统计云函数，云函数有2个
  • uni-stat-receiver 客户端数据上报函数（添加统计数据源）
  • uni-stat-cron 数据跑批处理函数（生成统计数据）
• 云数据库：uni-stat-为前缀的表
• 前端网站托管：部署uni-admin，管理员发布新版本

接下来，我们对不同资源，分别进行费用评估。

云函数

uni-stat-receiver

启用uni统计后，你的每一个在线用户默认每10秒会请求一次uni-stat-receiver云函数（如果你的日活在1万以上，可以改成60秒，可以减少费用。时间间隔可在manifest.json内设置，如果用户一直停留在一个页面，那么此时不会重复上报）

我们按照uniCloud官网列出的按量计费规则，计算一下云函数的资源消耗。

资源分类	资源细项	售价（元）
云函数	资源使用量（GBs）	0.000110592
	调用次数（万次）	0.0133
	出网流量（GB）	0.8
云数据库	容量（GB/天）	0.07
	读操作数（万次）	0.015
	写操作数（万次）	0.05
云存储	容量（GB/天）	0.0043
	下载操作次数（万次）	0.01
	上传操作次数（万次）	0.01
	CDN 流量（GB）	0.18
前端网站托管	容量（GB/天）	0.0043
	流量（GB）	0.18

我们可以简单得出如下公式：

云函数/云对象费用 = 资源使用量 * 0.000110592 + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8

其中：

• 资源使用量 = 云函数内存（单位为G） * 云函数平均单次执行时长（单位为秒） * 调用次数
• 调用次数 = 应用日活 * 每日活用户平均每天上报次数

我们假设如下数据模型：

• 云函数运行内存：128M，即0.125G（云函数内存默认为512M，用户可以自定义设置，最低可设置为128M）
• 每日活用户平均每天上报次数：10 次
• 云函数平均单次执行时长：100毫秒，即0.1秒
• 单次请求出网流量：0.7 KB

按照如上公式，若有100个日活用户，其uni统计的uni-stat-receiver云函数每天的费用为：

云函数费用（天） = 资源使用量 * 0.000110592  + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8
				= 云函数内存（单位为G） * 云函数平均单次执行时长（单位为秒） * 调用次数 * 0.000110592 + 调用次数 * 0.0133 / 10000 + 出网流量（单位GB） * 0.8
				= 0.125 * 0.1 * (100 * 10) * 0.000110592 + (100 * 10) * 0.0133/10000 + (100 * 10) * (0.7 / 1024 / 1024) * 0.8
				= 0.001382 + 0.00133 + 0.000534
				≈ 0.0032（元）

即：你的App日活为100，使用uni统计商业版后，uni-stat-receiver云函数每天大概消耗0.0032元。

据此，可计算其每月的费用为：0.0032 * 30 ≈ 0.1，即日活为100时，每月uni-stat-receiver云函数只需0.1元。

同理，我们可推导出日活为1000、10000、10万的App，其uni-stat-receiver云函数每月费用如下表：

日活	资源使用量计费（元/日）	调用次数计费（元/日）	出网流量计费（元/日）	日合计（元/日）	月合计（元/月）
100	0.001382	0.00133	0.000534	0.0032	0.10
1000	0.01382	0.0133	0.00534	0.0325	0.98
10000	0.1382	0.133	0.0534	0.3246	9.74
100000	1.382	1.33	0.534	3.2460	97.38

uni-stat-cron

uni统计还有一个云函数uni-stat-cron，它是定时数据跑批任务，用来将上报的数据进行统计，生成统计报表。

我们假设如下数据模型：

• 云函数内存：512M，即0.5G（跑批云函数建议设置为512M，因为它每天只运行24次，内存越大，性能越强）
• 云函数平均单次执行时长：1秒（随着数据源越多，运行时间越长）
• 每日执行次数：24次（固定每小时运行1次）
• 出网流量：没有返回给客户端，固定为0

其uni统计的uni-stat-cron云函数每天的费用为：

云函数费用（天） = 资源使用量 * 0.000110592  + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8
				= 云函数内存（单位为G） * 云函数平均单次执行时长（单位为秒） * 调用次数 + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8
				= 0.5 * 1 * 24 * 0.000110592 + 24 * 0.0133/10000 + 0
				= 0.001327104 + 0.00003192 + 0
				≈ 0.0014（元）

即：你的App日活为100，使用uni统计商业版后，uni-stat-receiver云函数每天大概消耗0.0014元。

据此，可计算其每月的费用为：0.0014 * 30 ≈ 0.04，即日活为100时，每月uni-stat-receiver云函数只需0.04元。

同理，我们可推导出日活为1000、10000、10万的App，其uni-stat-receiver云函数每月费用如下表：

日活	平均耗时（秒）	资源使用量计费（元/日）	调用次数计费（元/日）	出网流量计费（元/日）	日合计（元/日）	月合计（元/月）
100	1	0.001327	0.00003192	0	0.0014	0.04
1000	3	0.003981	0.00003192	0	0.0040	0.12
10000	30	0.039813	0.00003192	0	0.0398	1.19
100000	90	0.119439	0.00003192	0	0.1195	3.59

由于uni-stat-cron云函数不管多少日活，每日均只运行24次，故日活对其费用的影响很小（只影响了每次运行的时长）。

云数据库

按照uniCloud官网介绍，云数据库费用 = 容量费用 + 读操作次数费用 + 写操作次数费用，其中：

• 容量费用：数据库存储容量（单位为G） * 0.07
• 读操作次数费用：读操作次数（万次） * 0.015
• 写操作次数：写操作次数（万次） * 0.05

uni统计会产生大量的日志数据，但默认会有自动清除历史日志的策略，如：会话日志31天前的数据会被删除。

由于uni统计涉及数据库的情况非常复杂，我们通过对官方统计示例项目的实际运行数据得出以下结果：

日活为100的应用，uni统计数据库资源用量如下：

• 每日活用户平均每天上报次数：10 次
• 平均每次上报，需读取2次数据库，写入2次数据库（平均新增1.1条，修改0.9条），故新增插入1.1条记录，约0.54KB（注意：很多情况下上报可能没有数据新增，仅仅只是修改下会话日志数据。）

以上数据由官方统计示例项目计算得出。

故可得出以下数据模型：

• 日均云数据库容量：0.00052G（= 100 * 10 * 0.54 / 1024 / 1024）
• 日均云数据库读取次数：2000次（= 100 * 10 * 2）
• 日均云数据库写入次数：2000次（= 100 * 10 * 2）

因为数据源只保留31天，故稳定运行后，数据量容量一直会保持在31天的量。故下方公式中云数据库容量需要乘31

数据库费用（天） = 云数据库容量 * 31 * 0.07   + 读操作次数 * 0.015 / 10000 + 写操作次数 * 0.05/10000
				= 0.00052 * 31 * 0.07  + 2000 * 0.015/10000 + 2000 * 0.05/10000
				= 0.0011284 + 0.003 + 0.01
				≈ 0.0141（元）

即：如果你的uni统计业务日活为100，使用阿里云商业版云服务空间后，对应数据库每天大概消耗0.0141元。 据此，可计算其每月的费用为：0.0141 * 30 ≈ 0.42，即日活为100时每月云数据库只需0.42元。

日活	容量费（G）	读操作次数费用（元/日）	写操作次数费用（元/日）	日合计（元/日）	月合计（元/月）
100	0.0011284	0.003	0.01	0.0141	0.42
1000	0.011284	0.03	0.10	0.1413	4.24
10000	0.11284	0.30	1.00	1.4128	42.38
100000	1.1284	3.00	10.00	14.1284	423.85

云数据库搭配redis后费用对比

redis只影响数据库的读操作，通过官方统计示例项目使用redis的前后对比可知redis大概可以减少2/3的数据库读操作次数（等于减少2/3的数据库读次数费用）。

日活	读操作次数费用（元/月）（未开启redis）	读操作次数费用（元/月）（开启redis）	开启redis后每月减少的费用（元）
100	0.09	0.03	0.06
1000	0.90	0.30	0.60
10000	9.00	3.00	6.00
100000	90.00	30.00	60.00

由此可见，当日活低于10万时，redis减少的费用还不太明显。但当日活大于10万时，redis的作用越来越明显。

前端网页托管

uni统计需要和uni-admin配合使用，uni-admin需要部署在前端网页托管中。uni-admin主要是管理员使用，使用频次较少，流量也较低。

按照uniCloud官网介绍，前端网页托管费用 = 容量费 + 流量费。

容量费

uni-admin编译后为4.7M，按照官网每GB每天0.0043元的规则，uni-admin的月度容量费为：4.7 / 1024 * 0.0043 * 30 = 0.00059，不到1分钱，可忽略。

流量费

管理员登录uni-admin，到uni统计管理页面浏览统计数据，所需流量不超过3M，即使每月发布2次更新，流量费预估为：3 / 1024 * 0.18 * 2 = 0.00105，也不到1分钱，也可忽略。

前端网页托管总结

每月费用不到1分钱，可忽略。

费用合并

细项对比完了，我们来合并看看，使用uni统计，每月到底需要花多少钱。

日活	云函数（元/月）	云数据库（元/月）	前端网页托管 （元/月）	月合计（元/月）
100	0.14	0.42	可忽略不计	0.56
1000	1.10	4.24	可忽略不计	5.34
10000	10.93	42.38	可忽略不计	53.31
100000	100.97	423.85	可忽略不计	524.82

uni统计 给你带来的收益

使用uni统计，免费获取、一键安装，你将获得：

1. 全端

全端流量统计，一张报表可查看所有端（iOS、Android、Web 及各家小程序）的运营数据。

无需在各端接不同的sdk、无需在不同报表看数据。目前市面已知唯一一个一张报表看遍业务全景的方案。

2. 开源、免费、自由定制

代码全部开源。采集什么数据可以自定义；跑批频率可以自定义（搞活动时实时统计都可以做到）；展示报表可以自定义。

3. 私有部署、数据自控

使用传统saas类统计产品，所有数据都上报给统计服务厂商。

uni统计2.0基于uniCloud实现，云函数、统计数据全部托管在开发者自己的服务空间（阿里云或腾讯云自选）中，开发者对自己的统计数据拥有完整的控制权。

4. 有效的错误分析

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

uni统计的错误信息更全面，包括 js前端错误和 App 原生层的崩溃。

因为uni-app是编译后运行，传统web和小程序的统计平台，其js报错无法回溯到uni-app的编译前源码，报错看不懂。

uni统计支持sourcemap，可直观了解到底哪行代码写的有问题。详见

真实案例

一个半月全端获客400万的真实例子

总结

再次说回uni统计，通过上面的费用测算可得知，以日活1万来说，每个日活产生的一年的费用大概是6分钱到7分钱之间，这个费用已经是比较便宜的了。

目前市面上的统计如友盟统计也是收费的，在日活达到1万时，每年费用需要3109元/年（且这还只是web统计的费用，APP统计另算费用）。同时它还不是源码版本，代码不开源，无法随意定制。

而uni统计是全平台统计、代码开源、随意定制，这是三方统计平台做不到的。

再看回刚才的计算表，以日活1万来说，uni统计每年费用只需53.31*12=639.72元/年。

日活	云函数（元/月）	云数据库（元/月）	前端网页托管 （元/月）	月合计（元/月）
100	0.14	0.42	可忽略不计	0.56
1000	1.10	4.24	可忽略不计	5.34
10000	10.93	42.38	可忽略不计	53.31
100000	100.97	423.85	可忽略不计	524.82

不重复制造轮子，聚焦业务，快速验证模式，实现商业增长，才应该是聪明工程师的追求。

本篇评测共大家参考。

如何降低费用

• 1.适当增大前端数据上报周期 因为默认是10秒上报一次。改成60秒一次就可以降低6倍的访问量。具体调整方式可参考上文数据上报逻辑中有关前端数据上报周期的说明。
• 2.开启redis缓存 这也是目前降低uni统计2.0数据库查询次数最有效的方法。因为redis是按容量计费，读写次数再多也不会多花钱。redis开启方法可参上文开启redis缓存。
• 3.关闭实时统计 实时统计指云端实时运算统计报表。但现实中大多数人只关心昨天的统计报表。只有今天要搞促销时才会实时关注数据报表。可以在日常配置为按天统计，在搞活动时再调整配置为实时统计。修改方法：将实时统计的配置项设置为关闭状态，然后重新上传配置中心（uni-config-center）到关联的服务空间即可。配置项说明可查看上文公共模块配置项说明。

常见问题

1. 启动uni统计后，何时可以查看报表数据？

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

2. 已经开启统计，定时任务配置也正常，但是后台还是看不到数据

答：

• 确保分清楚，业务App 和 admin 是2个工程。业务App是采集端，admin是报表端
• 确保使用HBuilderX 3.4.14+。如果是cli创建的项目，需要升级cli到uni-app 3.4.14+
• 确保在需要统计的业务App工程的manifest里勾选了开启 uni统计2.0，并关联了正确的uniCloud服务空间
• 确保重新发行过业务App（在HBuilder里发行即可，不需要上架应用商店或小程序商店），数据上报只发生在项目发行后或者运行项目开启了调试模式，其他情况不会上报数据。详情
• 确保uni-admin项目的uniCloud目录下的云函数都上传到了与App相同的uniCloud服务空间
• 在uniCloud web控制台的云函数日志中，可以看到uni-stat-receiver云函数有正确的请求日志
• 在uniCloud web控制台的云函数日志中，可以看到uni-stat-cron云函数有定时执行日志，且日志显示执行成功；如日志中显示Not Found the cofnig file，则查看下方第6个问题；
• 如需看uni-admin这个管理端的统计数据，才需要在uni-admin工程的manifest里配置uni统计2.0并再次发行。再次强调不要搞混业务App和admin

3. 如何判断是否需要配置分钟级定时任务？

答：一般情况下是不需要自行配置的，但如果定时任务云函数（uni-stat-cron）出现运行超时的情况时，就要考虑去开启分钟级定时任务了。

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

答：参考uni-admin 给系统创建多个登录账户并设置不同的权限

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

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

6. uni-stat-cron运行日志显示 Not Found the config 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公共模块即可。
• 以uni-admin为主：将业务App项目下的uni-config-center，手动合并配置项到uni-admin项目下的uni-config-center中（注意：是手动合并配置项，不要整体覆盖文件），然后重新上传uni-admin项目下的uni-config-center公共模块即可。

7. 子账号需要赋予哪些表的权限才能正常查看uni统计

首先分三步骤

第一步：添加用户角色权限

1. 去权限管理，添加一个权限id为：READ_UNI_STAT 的权限

2. 去角色管理，添加一个角色id为：READ_UNI_STAT 的角色

3. 去用户管理，赋予子账号角色 READ_UNI_STAT 角色

第二步：给相关的表设置read权限

涉及表如下：

1. 所有 uni-stat- 开头的表
2. uni-pay-orders
3. opendb-app-list
4. opendb-app-versions

需要赋予上面的表的 read 权限

将上面的表的 read 权限全部设置为

"permission": {
	"read": "'READ_UNI_STAT' in auth.permission",
	"create": false,
	"update": false,
	"delete": false
},

第三步：前往菜单管理，对每一个uni统计的页面（包含子页面）设置下权限 READ_UNI_STAT（菜单只有拥有对应权限才会显示）

8. 某统计项突然没有数据怎么办？

答：首先登录uniCloud控制台，检查在出现问题的统计项配置的时间点(参考：定时任务配置说明)，uni-stat-cron云函数的运行日志，如果运行日志前面的状态标识是灰色的，代表云函数运行超时了，此时在云函数详情中将uni-stat-cron云函数的超时时间设置到最大值即可。如果运行日志的状态标识是绿色的，则需要检查日志内容是否有报错，然后根据报错内容做出调整。

9. 为什么注册用户统计没有数据？

答：uni统计能够产出注册用户统计数据的前提是，开通uni统计的应用与uni-admin项目关联了同一个服务空间，且用户模块使用了uni-id用户体系，如果你应用的用户存储在非uniCloud业务，或者没有使用uni-id用户体系，uni统计将无法自动统计注册用户数据。

参考资料

不掌握如下文档，很难对 uni统计2.0 吃透和做二次开发

• uni-admin文档：详见
• uni-id文档：详见
• opendb文档：详见