全埋点需运行时判断平台并隔离AppKey：H5/小程序等端必须在运行时用uni.getSystemInfoSync()等检测，编译时#ifdef会剔除导致初始化失败；iOS、Android、小程序、H5须分别申请独立AppKey，混用致数据错乱；autoGetOpenid需后台配全AppID/AppSecret，否则静默失败；页面名应从pages.json或路由meta读取，避免硬编码。
为什么直接在 main.js 里用 #ifdef 判断平台会丢数据
很多人照着文档写：#ifdef MP-WEIXIN 引入 umtrack-wx，#ifdef H5 引入 umtrack-web，然后调 init()。看起来天衣无缝，但实际 H5 端根本收不到任何数据。
原因很实在：#ifdef H5 块在微信小程序编译时被 HBuilderX 完全剔除；反过来，H5 编译时又把 MP-WEIXIN 块干掉了。问题在于——某些平台（比如 H5）根本不执行这些条件块里的代码，也没报错，就安静地跳过了初始化。
- 真正有效的判断必须发生在运行时，比如
uni.getSystemInfoSync().platform === 'ios'或检查全局变量__mpWeixin -
process.env.VUE_APP_PLATFORM可以用，但得确保你在 vue.config.js 或 manifest.json 里提前注入了对应值 - 别信「编译时自动适配」，uni-app 的条件编译不是运行时路由分发器
友盟多端 AppKey 必须严格隔离，混用等于白接
一个 uni-app 项目打到 iOS、Android、微信小程序、H5 四个端，就得申请四个独立 AppKey：
- iOS：去友盟「U-App」创建，填 Bundle ID（对应
manifest.json中的id字段） - Android：同属「U-App」，但填 package name（同样来自
manifest.json），不能复用 iOS 的 AppKey - 微信小程序：必须进「U-Mini Program」，选「微信小程序」类型，填小程序 AppID，拿专属 AppKey —— 这个和 iOS 的完全不通用
- H5：进「U-Web」，填主域名（如
https://app.example.com），二级域名要提前在后台「域名管理」加白名单
混用 AppKey 最典型的现象是：iOS 端数据出现在小程序报表里，或者 H5 页面访问量始终为 0 —— 后台根本没把请求路由到正确实例。
封装 UmengTracker 类时，autoGetOpenid 是个隐藏卡点
小程序端如果开启 autoGetOpenid: true，SDK 会在首次 init() 时主动调用微信 API 获取 openid。但这个动作依赖友盟后台已配置好 AppID + AppSecret。
如果你只填了 AppID 没填 AppSecret，或填错了，SDK 不会抛错，而是卡住 2–3 秒后静默失败，后续所有事件都积压不上报，且控制台毫无提示。
- 务必登录友盟后台 →「设置 → 应用信息」→ 找到对应小程序应用 → 补全 AppID 和 AppSecret
- 测试时用真机扫码，开发者工具里
wx.login行为受限，容易误判 - 上线前建议关掉
autoGetOpenid，改用业务层自己取 openid 后手动传给trackEvent
页面名不要硬编码，从 pages.json 或路由 meta 读取
手动写 trackEvent('page_view', { page: 'pages/home/index' }) 很快就会失控：路径改了、页面重命名了、tabBar 页面结构变了……后台看到的全是散列的 page 字段，根本没法聚合分析。
更稳的做法是统一从 pages.json 解析，或在路由定义里加 meta：
// router/index.js
{
path: '/home',
name: 'Home',
component: () => import('@/pages/home/index.vue'),
meta: { umengPageName: '首页' }
}
然后在页面 onShow 里读取：const pageName = getCurrentPages()[0].route || this.$route?.meta?.umengPageName。这样改页面名只改一处，埋点字段自动对齐。
真正难的从来不是怎么发数据，而是让每条数据在后台能被准确归因、可对比、可持续维护。跨端埋点最易被忽略的，其实是各端初始化时机是否真实触发、AppKey 是否物理隔离、页面标识是否来源唯一——这些点一旦松动，后面所有分析都是空中楼阁。
