uni-stat-v1.md

::: warning 注意 
 您正在浏览的是老版uni统计1.0的文档。推荐升级到[uni统计2.0](uni-stat-v2.html)
:::

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

1. 无需在各端接不同的sdk、无需在不同报表看数据。uni统计：一张报表看遍业务全景。
2. 拉通内容。让你知道用户到底喜欢你提供的什么内容，不管是新闻app里的新闻，还是购物app里的商品，都可以一目了然的看到全景。

web控制台地址：[https://tongji.dcloud.net.cn](https://tongji.dcloud.net.cn)

## 第一步、配置统计开关

自 uni-app 2.2.3版本后，`uni-app`项目在发布时会默认启用 uni统计，开发者可在[https://tongji.dcloud.net.cn](https://tongji.dcloud.net.cn)查看数据报表。
但从 uni-app 2.7起，默认值改为了不启用。需要在manifest中手动配置开启。

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

![选择 uni统计](https://img-cdn-tc.dcloud.net.cn/uploads/article/20200428/761d2dca6ce34febfc4d43c09c6fd85f.jpg)

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

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

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

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

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

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

## 第三步、使用HBuilderX 2.2.3以上或对应的cli版发行应用

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

## 第四步、登陆统计后台看数据
uni统计报表网址：[https://tongji.dcloud.net.cn](https://tongji.dcloud.net.cn)

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

如果appid对应的项目的所有者发生变更，请参考[如何转让应用](http://ask.dcloud.net.cn/article/12861)

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

--------------------

## 发行时为什么提示“当前应用未配置Appid，无法使用uni统计”

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

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

此时，开发者可通过HBuilderX、[DCloud开发者中心](https://dev.dcloud.net.cn)两个入口创建应用，获取Appid。

**方式1. 登录HBluiderX获取**

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

![获取appid](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/4e33ea58-4d1b-4a9b-a865-d9ac23009567.png)

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

登录[DCloud开发者中心](https://dev.dcloud.net.cn)，在线创建应用，然后将新应用的appid填写到manifest.json中

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

Tips
- 使用 uni 统计必须配置 `APPID` 才能正常使用
- 获取以及创建的 `APPID` 是与您的 `DCloud` 账号绑定的，请不要随意填写，否则将不能正常获取上报内容
- 部分开发者不重视Appid，在不同应用中使用相同的appid，请修改这些错误的行为。
- 附参考文章：[DCloud的Appid有什么用，如需转让应用怎么做](https://ask.dcloud.net.cn/article/35907)


## 注意事项
- uni统计具备当日实时数据统计功能，但这个实时，仍然要经历一定运算时间，一般在3分钟到1个小时内的不等。
- 如果开发者连续3日不登录uni统计控制台，则暂停实时统计服务；再次登录后1小时内会开始进行实时统计。这种暂停不影响日报、不影响整体数据准确性。
- 如果开发者连续1个月不登录uni统计控制台，则暂停数据上报功能。再次登录后点击按钮恢复数据上报。暂停前系统会发送提醒邮件给开发者。暂停期间，数据不再记录，历史数据不受影响。恢复后，暂停期间的数据也无法恢复。

## 常见问题 

1. 后台数据一直显示 0 ，看不到数据上报
- 请检查 `manifest.json` 是否配置 uni 统计为开启
- 如已经配置请检查 `HBuilderX` 是否升级到 `2.2.3` 版本以上，`CLI` 方式是否升级到最新。
- 请确认小程序的服务器域名名单中加入了`tongji.dcloud.io`
- 请确认带有uni统计的新版本已经发布到手机上并且启动运行
- 统计数据有几十分钟的延迟，如果是刚配上，请等一会再刷新报表
- 应用需发布后才有数据，运行期不上报数据
- 当日实时统计显示逻辑：3天内未登录统计后台的应用不会处理当日实时统计；再次登录后1小时内会开始进行实时统计。
2. 自定义事件怎么用 
 使用 `uni.report()` API 上报数据，详见[自定义事件说明](https://ask.dcloud.net.cn/article/36304)

3. 内容统计是什么/ 页面规则怎么配置
 内容统计是uni统计的特色功能之一，是内容详情页的访问统计，详见[内容统计说明](https://ask.dcloud.net.cn/article/36299)

4. 不支持导入老数据合并统计。uni统计需要自开通上线后才有数据

5. 售卖用户数据，或未经用户同意共享数据给第三方，属于违法行为，DCloud严格遵守国家法律要求，uni统计可安心使用。