本页目录
  1. 支持的平台
  2. 接入的四个步骤
  3. 1. 登记应用标识
  4. 2. 按向导安装 SDK
  5. 3. 先预初始化,用户同意后再初始化
  6. 4. 真机冷启动一次
  7. 看不到数据时
  8. 不发版也能调整的远程配置
  9. 排除测试机
  10. 下一步

应用统计需要 Pro 及以上套餐,免费版只包含网站。

支持的平台

  • 原生:iOS(13 起)、Android(minSdk 21 起)、HarmonyOS。
  • 跨平台:Flutter、React Native、uni-app。
  • 和网站、小程序放在同一个项目里时,报表可以按平台分开看,也可以合在一起看。

不同平台 SDK 自动记录的内容略有差别。比如 iOS 会自动捕获未处理的异常,Android 当前版本需要你在启动代码里手动转发生命周期并上报崩溃。控制台的接入向导会按平台说明。

接入的四个步骤

1. 登记应用标识

到「应用统计 › 配置 › SDK 代码」添加应用标识:iOS 写 Bundle ID,Android 写包名,HarmonyOS 写鸿蒙包名。必须和安装包里的值逐字一致,不一致的上报会被拒收,而且不会报错。

2. 按向导安装 SDK

同一页会按你选的平台给出安装命令和初始化代码,站点标识和采集地址都已经填好,直接复制即可。版本号以向导为准。

3. 先预初始化,用户同意后再初始化

SDK 分两步启动:

  • 预初始化:只保存配置,不发任何网络请求。放在应用启动的最早阶段。
  • 初始化:开始采集和发送。在用户同意隐私政策之后调用。

在中国大陆上架的应用,应用商店审核要求用户同意隐私政策之前不能收集信息。打开项目的「国内模式」后,没有授予同意之前 SDK 不会采集任何数据。其他地区的应用也建议按这个顺序写,以后改合规策略时不用动代码。

4. 真机冷启动一次

装到真机或模拟器上,完全退出后重新打开。然后到「应用统计 › 实时」看,能看到启动事件就说明通了。

看不到数据时

按这个顺序检查:

  1. 应用标识是否和安装包一致(大小写也算)。
  2. 项目套餐是否包含应用平台。
  3. 是不是在用户同意之前就调用了初始化,或者国内模式下还没授予同意。
  4. 控制台里的远程开关是否被关了(见下)。

不发版也能调整的远程配置

应用发出去之后再改代码要等审核。所以有一部分采集开关放在控制台,SDK 启动时拉取:

  • 总开关:关掉后 SDK 停止发送,本地队列保留。
  • 采样比例:1% 到 100%,按设备稳定抽样,同一台设备不会这次采下次不采。
  • 上报间隔和批量大小。
  • 事件黑名单、设备黑名单。
  • 最低 SDK 版本:低于它的旧安装包停止上报。

位置在「应用统计 › 配置 › SDK 代码」的远程配置卡片。保存后,SDK 在下一次冷启动或本地缓存过期(默认一天)时生效。目前 Flutter、React Native、uni-app、HarmonyOS 和小程序读取这份配置,iOS 和 Android 原生 SDK 的当前版本还不读取。

排除测试机

在「应用统计 › 配置 › App 设置」里按设备或版本排除。版本支持末尾带星号,比如 0.9.* 排除所有内测版。

下一步

本主题下一篇微信、支付宝、抖音小程序接入