uni-app集成友盟统计需分平台:微信小程序用umtrack-wx(npm安装+main.js初始化),App端配manifest.json中statics节点;事件上报小程序用$uma.trackEvent(),App用uni.reportAnalytics(),且两套key不可混用。

uni-app 集成友盟统计 SDK,核心取决于你最终的发布目标:微信小程序走 umtrack-wx,App(iOS/Android)走 manifest.json + 原生 SDK 配置,两者不能混用,否则数据不上报或上报错乱。
微信小程序用 umtrack-wx,别碰 manifest.json 里的友盟配置
uni-app 编译到微信小程序时,manifest.json 中的 umeng 配置完全无效——小程序不走 5+ 原生统计通道,必须用友盟专为小程序封装的 umtrack-wx SDK。
-
npm install umtrack-wx@latest --save,注意版本要 >= 2.0.0(旧版不兼容微信基础库 2.25+) -
main.js中初始化必须在Vue.use()之前,且appKey必须是友盟「U-Mini Program」后台创建的小程序应用所分配的 key,不是「U-App」的 iOS/Android key -
useOpenid: true且autoGetOpenid: true时,需提前在友盟后台「设置管理 → 应用信息」填好小程序的appId和secret,否则 openid 拿不到,用户去重失效 - 调试阶段设
debug: true,控制台会输出[UMENG] event: xxx日志;上线前务必关掉,否则影响首屏性能
App(iOS/Android)必须配 manifest.json,npm 包无效
打包成 App 时,umtrack-wx 或任何 npm 引入的 JS SDK 都不会生效——App 端依赖的是 uni-app 底层调用的原生 SDK,只能通过 manifest.json 配置驱动。
- 切换到 HBuilderX 的「源码视图」,在
"app-plus"→"distribute"→"sdkConfigs"下添加"statics"节点 -
appkey_ios和appkey_android必须分别对应友盟「U-App」后台为 iOS/Android 单独创建的应用,不能共用一个 key -
channelid_ios/channelid_android可填任意非空字符串(如"official"),但上线后若需分渠道归因,这里就得和实际分发渠道严格一致 - 勾选「Statistic(统计)」模块只是 UI 提示,真正起作用的是
statics节点内容;漏写该节点,打包后统计完全静默
自定义事件怎么打?小程序和 App 写法不同
事件上报接口不统一:小程序用 $uma.trackEvent(),App 端必须用 uni.reportAnalytics()(uni-app 官方桥接方法),不能直接调友盟原生 API。
- 小程序中:
this.$uma.trackEvent('button_click', { page: 'home', type: 'primary' })—— 第二个参数是可选对象,字段名随意,但单个 key 长度不能超 50 字符,value 类型仅支持 string/number/boolean - App 中:
uni.reportAnalytics('button_click', { page: 'home', type: 'primary' })—— 这个调用会被 uni-app 自动转给友盟原生 SDK;如果没在manifest.json正确配置,该调用无声失败,无报错、无日志 - 两者都禁止在
onLaunch或onShow里批量打点,容易触发友盟限频(默认 10 条/秒),导致后续事件丢弃
数据延迟与验证要点
友盟数据从上报到后台可见,存在固有延迟:小程序通常 1–3 小时,App 端约 30 分钟;刚集成时别盯着实时报表看,先确认日志或原始数据是否发出。
- 小程序真机调试时,在「开发工具 → 控制台」搜
UMENG,能看到带upload的请求成功日志;没日志说明初始化失败或网络被拦截 - App 打包后开启
debug模式(HBuilderX 运行 → 选择「自定义基座」并勾选「调试模式」),日志中会出现[UMENG] upload success - 友盟后台「实时数据」页只显示最近 30 分钟数据,且默认按「小时」聚合;要看具体事件明细,得进「事件分析 → 自定义事件」页面,并手动选择时间范围
最容易忽略的是:同一个 uni-app 项目同时发布小程序和 App 时,必须维护两套独立的友盟应用配置(小程序用 U-Mini Program key,App 用 U-App 的双平台 key),并且代码中事件上报逻辑要按平台条件判断,否则数据会串流或丢失。


















