uni-app统计1.0入门教程

发布于 1周前 作者 sinazl 来自 Uni-App

uni-app统计1.0入门教程

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统计，如下图：

manifest配置

如果不使用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小时内会开始进行实时统计。

  2. 自定义事件怎么用 使用 uni.report() API 上报数据，详见自定义事件说明

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

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

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

开发环境 版本号 项目创建方式
HBuilderX 2.2.3及以上 创建新项目或已有项目配置
CLI 最新版本 创建新项目或已有项目配置

Harmonyos Next教程
1 回复

当然，以下是一个针对uni-app统计1.0的简单入门教程示例，包含基本的集成和页面访问统计代码案例。

uni-app统计1.0入门教程

一、准备工作

  1. 创建uni-app项目： 使用HBuilderX或者命令行工具创建一个新的uni-app项目。

  2. 引入统计SDK： uni-app提供了官方的统计SDK，可以通过插件市场安装或者手动集成。这里假设已经通过插件市场安装了统计SDK。

二、集成统计SDK

  1. 配置manifest.json： 在manifest.json文件中添加统计SDK的配置。
"mp-weixin": {
    "appid": "your-app-id",
    "setting": {
        "urlCheck": false
    },
    "usingComponents": true,
    "condition": {}
},
"plugins": {
    "uni-stat": {
        "version": "1.0.0",
        "provider": "wxa999999999999999" // 替换为实际插件ID
    }
}
  1. 初始化统计SDK： 在main.js文件中初始化统计SDK。
import Vue from 'vue'
import App from './App'
import uniStat from '@/plugins/uni-stat' // 假设SDK已放置在plugins目录下

Vue.config.productionTip = false

App.mpType = 'app'

const app = new Vue({
    ...App
})

// 初始化统计SDK
uniStat.init({
    appKey: 'your-app-key' // 替换为你的统计AppKey
})

app.$mount()

三、页面访问统计

  1. 自动统计页面访问： SDK通常会自动统计页面访问数据，但你也可以手动触发统计以确保数据准确性。

  2. 手动统计页面停留时间： 在页面的onLoad和onUnload事件中手动记录页面访问。

export default {
    onLoad() {
        // 页面加载时记录开始时间
        this.startTime = new Date().getTime();
    },
    onUnload() {
        // 页面卸载时记录结束时间并上报
        const endTime = new Date().getTime();
        const stayTime = endTime - this.startTime;
        uniStat.reportPageStayTime({
            pagePath: getCurrentPages()[0].route, // 当前页面路径
            stayTime: stayTime
        });
    }
}

四、运行并验证

  1. 运行项目： 在HBuilderX中运行项目，确保没有错误。

  2. 查看统计数据： 登录统计后台，查看页面访问、用户行为等统计数据。

以上是一个简单的uni-app统计1.0入门教程示例，展示了如何集成统计SDK并进行页面访问统计。根据实际需求，你可以进一步配置和扩展统计功能。

回到顶部