dcloud uni统计使用教程

uni-app 自 2.2.3版本开始新增 uni 统计，支持全平台业务统计，包括App、H5及各家小程序。

web控制台地址：https://tongji.dcloud.net.cn

第一步、配置统计开关

自 uni-app 2.2.3版本后，uni-app项目在发布时会默认启用 uni统计，开发者可在https://tongji.dcloud.net.cn查看数据报表。

但从 uni-app 2.7起，默认值改为了不启用。需要在manifest中手动配置开启。

在HBuilderX中打开manifest，选择 uni统计，如下图：

如果不使用HBuilderX，也可在 manifest.json 的源码视图中手动关闭 uni统计

将 manifest.json -> uniStatistics 下的 enable 字段设置为 false 来关闭 uni 统计

//...
"uniStatistics": {
"enable": false//全局关闭
},//...

注意：uniStatistics支持分平台设置，比如若需仅关闭微信平台的 uni统计，则在mp-weixin节点下设置uniStatistics ->enable即可，如下：

//...
"mp-weixin":{
"uniStatistics": {
"enable": false //微信平台关闭统计
}}

由于各家小程序对可访问的域名要配置白名单，否则无法联网，所以需要将tongji.dcloud.io配入服务器域名列表。详细教程可参考https://ask.dcloud.net.cn/article/36298

应用在运行、调试时不会上报统计数据，仅在发行后，并启动新版的App、h5、小程序，才会上报数据。

uni统计报表网址：https://tongji.dcloud.net.cn

请使用正确的DCloud账户登陆后台，每个DCloud账户登陆后可看到自己名下创建的应用。如果看不到期待的应用，那说明这个账户不是某个应用的所有者。

如果appid对应的项目的所有者发生变更，请参考如何转让应用

数据报表更新有延时，手机端上报数据后延迟几十分钟可在后台报表看到数据。

uni统计以appid区分不同应用，因此在编译项目时，若发现当前应用未配置appid，则会在控制台显示如下警告提醒：

当前应用未配置Appid，无法使用uni统计

此时，开发者可通过HBuilderX、DCloud开发者中心两个入口创建应用，获取Appid。

方式1. 登录HBluiderX获取

在HBluiderX中先登录，然后在项目根目录打开 manifest.json，在可视化界面点击获取 APPID 获取，无需其他设置，如下图

获取appid

方式2. 登录DCoud开发者中心获取(即将支持)

登录DCloud开发者中心，在线创建应用，然后将新应用的appid填写到manifest.json中

{
// ...
"appid":"创建的 appid"
// ...}

Tips

如果开发者连续1个月不登录uni统计控制台，则暂停数据上报功能。再次登录后点击按钮恢复数据上报。暂停前系统会发送提醒邮件给开发者。暂停期间，数据不再记录，历史数据不受影响。恢复后，暂停期间的数据也无法恢复。