更多： 应用统计
简短回答
不用额外写代码：SDK 会在每个事件上带 $app_version，Android 和鸿蒙取 versionName，iOS 取 CFBundleShortVersionString。打开 应用统计 › 用户分析 › 版本分布 看每个版本的活跃占比、崩溃次数和首次出现日期；只有要覆盖时才在配置里设置 appVersion。
简短回答
不用额外写代码：TapCub SDK 会在每个事件上带 $app_version，Android 取 versionName，iOS 取 CFBundleShortVersionString，鸿蒙取 versionName。打开 应用统计 › 用户分析 › 版本分布，就能看每个版本的活跃占比、崩溃次数和首次出现日期。
1. 确认版本号从哪里来
| 平台 | 默认版本号 | 覆盖方式 |
|---|---|---|
| Android | versionName（构建号 versionCode） | 配置里的 appVersion |
| iOS | Info.plist 里的短版本号 | 配置里的 appVersion |
| 鸿蒙 | versionName | 配置里的 appVersion |
只有商店里的版本号和构建值不一致时才需要覆盖，比如同一个构建用两个名字发布：
TapCub.preInit(this, TapCubConfig(siteKey = "YOUR_SITE_KEY", appVersion = "2.4.0"))格式要统一（不要这次写 v2.4、下次写 2.4.0），否则同一次发布会显示成两行。
2. 看版本分布
每个版本一行：平台、活跃占比、崩溃次数、首次出现日期。分布图堆叠前 8 个版本，其余合并为「其他」。应用概览的「最新发布」卡片只显示各平台最新的版本，完整名单以这一页为准。
示例：发布一周后，2.4.0 占活跃用户的 46%，2.3.2 占 38%，更早的版本合计 16%。
3. 按版本对比稳定性
在版本表里点一行，会把这个版本加为当前页的筛选。崩溃细节在 应用统计 › 质量与归因 › 稳定性，无崩溃率的算法见无崩溃率。最新版本的崩溃上升、旧版本平稳，问题多半在这次发布，而不是设备构成。
从侧栏切换报表时只保留平台和单个应用的筛选，版本筛选不会带过去，到下一个报表要重新加。
4. 渠道
应用统计 › 用户分析 › 渠道分析 按事件上的 $channel 分组（不是归因回传里的媒体来源），没有该字段的归到「(无渠道)」。
常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 同一次发布显示成两个版本 | 不同构建的版本号写法不一样 | 统一格式，或设置 appVersion |
| 版本筛选不见了 | 侧栏切换只保留平台和应用 | 重新加筛选 |
| 没有「版本分布」菜单 | 这是小程序项目 | 小程序看场景值 |
| 应用完全没有数据 | appId 和控制台登记的应用不一致 | 改正 appId |
相关阅读
这篇回答解决你的问题了吗？
我们会根据反馈修改和补充这篇内容。
提交没有成功，请稍后再试。
谢谢你的反馈，我们会据此改进这篇内容。你已经反馈过这篇了，谢谢。