DCloud_UNI_HT
DCloud_UNI_HT
  • 发布:2019-08-20 16:36
  • 更新:2023-12-19 13:53
  • 阅读:136833

uni统计1.0入门教程

分类:uni-app

uni统计2.0已经发布 ,uni统计2.0 是开源、全端、云端一体的统计平台。另行查看:文档

以下是uni统计1.0的文档

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

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

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

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

第四步、登陆统计后台看数据

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

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

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

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


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

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

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

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

方式1. 登录HBluiderX获取

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

获取appid

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

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

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

Tips

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

注意事项

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

常见问题

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

  2. 内容统计是什么/ 页面规则怎么配置
    内容统计是uni统计的特色功能之一,是内容详情页的访问统计,详见内容统计说明

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

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

18 关注 分享
诺墨 DCloud_heavensoft 参宿四 7***@qq.com libojacky f***@163.com j***@163.com 2***@qq.com k***@163.com j***@163.com 1***@qq.com 闲人Jake 1***@qq.com 映月辉煌 z***@163.com 小杨努力CV 2***@qq.com DCloud_UNI_HRK

要回复文章请先登录注册

墨风行笙

墨风行笙

这个h5直接开设置里面的统计就好了嘛,开了也上传了,大概需要多久可以看见统计信息
2023-12-19 13:53
1***@189.cn

1***@189.cn

控制台显示 ​已开启 uni统计1.0 版本​,但后台一直该应用未开通uni统计或目前还没有上报统计数据。如果确认已开启uni统计,等待数据成功上报后刷新页面即可查看。这个是什么原因呢?
2023-09-26 11:30
小黑子爱rap

小黑子爱rap

我只发布了H5,uni统计1.0为什么一直显示0,是我少配置了什么东西嘛
2023-08-02 00:23
Scitico

Scitico

近一年的APP,之前用1.0的统计正常,这两周改为2.0,编译发布,发现所有新增用户数一直为0.实际上是有的。明显感觉统计不正常,请问如何解决?
2023-03-01 20:18
DCloud_UNI_HT

DCloud_UNI_HT (作者)

回复 7***@qq.com :
需要
2023-01-31 09:55
7***@qq.com

7***@qq.com

请问开启了统计并发行编译了之后需要重新上架各大应用商城吗
2023-01-30 15:16
gzxd

gzxd

回复 DCloud_UNI_HT :
你好,我的项目出现了和 @ringyee 完全相同的情况,请问解决了吗,方便的话说下解决方法
2023-01-29 17:35
ringyee

ringyee

回复 DCloud_UNI_HT :
已经私聊啦,谢谢您
2023-01-28 17:29
DCloud_UNI_HT

DCloud_UNI_HT (作者)

回复 ringyee :
私聊一个联系方式 ,我看看
2023-01-28 16:56
ringyee

ringyee

回复 DCloud_UNI_HT :
是true
2023-01-28 16:55