uni-app中友盟统计需分端接入：App端用插件市场umeng-statistics插件；H5端在index.html引入JS SDK并挂载；小程序需专用SDK及独立AppKey。
uni-app 里怎么加友盟统计 SDK
直接用 uni-app 官方推荐的插件市场方案最稳，别自己手动引 JS。iOS 和 Android 原生层必须走原生 SDK，H5 端才能用 JS 版——混着用会漏数据。
- App 端（iOS/Android）：必须通过
uni-app插件市场安装umeng-statistics插件，它会自动注入原生 SDK 并桥接uni.$um方法 - H5 端：插件不生效，得单独在
index.html中引入友盟 JS SDK，并挂载到window._czc或用uni.getSystemInfoSync().platform === 'h5'分支处理 - 小程序端（微信/支付宝）：不支持友盟原生统计，只能用其小程序专用 SDK，且需单独申请 AppKey，和 App/H5 的 key 不通用
App 启动时初始化友盟失败的常见原因
初始化失败基本是配置没对上，不是代码问题。尤其是 iOS 上容易卡在白屏或报 UMConfigure is not initialized 错误。
- iOS 需在
manifest.json → App SDK 配置 → 友盟统计中填入正确的appkey和channel，且必须勾选「启用」；漏勾选会导致原生层完全不加载 - Android 要检查
android:name是否写在application标签下（不是activity），否则UMConfigure.init不触发 - 真机调试才有效，模拟器和 HBuilderX 内置浏览器不会上报；日志看
logcat或 Xcode 控制台里有没有UMDebug输出
页面级埋点怎么写才不重复、不漏发
别在 onLoad 里直接调 uni.$um.onPageStart，生命周期执行顺序和页面栈管理会让它错乱。要用 onShow + 页面路径判重。
- 统一在
pages.json的每个页面配置style.navigationBarTitleText，然后在onShow中取getCurrentPages().pop().route当做 pageId 传给uni.$um.onPageStart - 避免在
onHide里调onPageEnd—— 页面被遮挡（比如弹窗、tabBar 切换）也会触发，导致提前结束；应只在真正离开页面时（如跳转前）手动调一次 - 自定义事件用
uni.$um.onEvent，事件名别带空格或特殊字符，后端解析时会截断；参数值建议用字符串或数字，别传对象（SDK 会丢掉）
多端共用一套埋点逻辑但数据对不上怎么办
不是代码写错了，是各端统计口径天然不同：App 端按 Activity 生命周期，H5 按路由变化，小程序按 Page 实例。强行“统一”反而失真。
- App 和小程序可以对齐「页面曝光」行为，但 H5 必须监听
uni.addInterceptor的路由拦截，或改用vue-router的afterEach钩子补全 - 用户 ID 上报：App 端用
uni.$um.profileSignIn，H5 用_czc.push(['_setAccount', uid])，两者字段名、时机、有效期都不一样，别指望后端自动合并 - 测试阶段务必打开友盟 Debug 模式（
UMConfigure.setLogEnabled(true)），看每条日志是否打出、时间戳是否合理，比看后台报表准得多
跨端埋点最难的从来不是怎么写，而是接受“同一套逻辑在不同端必然产出不同数据”。关键路径先保 App 和小程序，H5 单独校验，别试图用一个 if 分支打天下。
