Android端Firebase Analytics手动屏幕追踪不生效问题咨询

• 未关闭官方默认的自动屏幕追踪功能：手动上报SCREEN_VIEW事件的前提是必须先禁用自动收集，否则自动上报的事件会和手动上报的事件冲突，导致控制台过滤掉不符合校验规则的手动上报事件。
• 事件调用时机错误：在onCreate阶段Activity还未完成生命周期初始化，Firebase SDK对SCREEN_VIEW事件有内部生命周期校验，过早调用的事件会被直接丢弃。
• SDK版本兼容问题：部分老旧版本的Firebase Analytics SDK存在手动上报SCREEN_VIEW事件不生效的已知bug，未升级到稳定版本会触发该问题。
• 参数格式不符合要求：SCREEN_NAME参数最多支持100个字符，仅允许包含字母、数字、下划线和空格，包含特殊字符或长度超限的参数会导致事件被丢弃。

1. 先在AndroidManifest.xml的application节点下添加配置，关闭自动屏幕追踪：

<!-- 关闭Firebase Analytics自动屏幕追踪 -->
<meta-data
    android:name="firebase_analytics_collection_screen_view_enabled"
    android:value="false" />

2. 将事件上报逻辑从onCreate方法迁移到onResume方法中，确保Activity完成初始化后再上报：

override fun onResume() {
    super.onResume()
    val bundle = Bundle().apply {
        putString(FirebaseAnalytics.Param.SCREEN_CLASS, this.localClassName)
        putString(FirebaseAnalytics.Param.SCREEN_NAME, "My Screen")
    }
    FirebaseAnalytics.getInstance(this).logEvent(FirebaseAnalytics.Event.SCREEN_VIEW, bundle)
}

3. 升级Firebase SDK到最新稳定版本，建议使用Firebase BOM统一管理依赖版本，避免不同组件版本冲突：

dependencies {
    // 导入Firebase BOM，版本替换为最新稳定版即可
    implementation platform('com.google.firebase:firebase-bom:32.7.0')
    implementation 'com.google.firebase:firebase-analytics-ktx'
}

4. 检查SCREEN_NAME和SCREEN_CLASS参数的格式，确保没有特殊字符、长度未超出限制。

• Debug环境下开启Firebase DebugView，触发页面跳转后等待30秒内即可看到screen_view事件上报，附带的参数会同步展示。
• 正式环境的数据最长需要等待24小时即可在Firebase控制台的事件分析页面查看对应统计数据。

内容的提问来源于stack exchange，提问作者Mehmed Mert