Firebase Analytics中部分屏幕类全限定原因及screen_view事件重复显示问题

这两个问题本质都和追踪方式的一致性以及项目架构/平台细节有关，下面分点拆解说明：

一、为什么部分屏幕类会显示为全限定形式？ #

主要源于以下几个常见场景：

• 自动追踪与手动追踪的差异：Firebase默认自动屏幕追踪（比如iOS对UIViewController、Android对Activity的自动捕获）通常只上报简单类名（如ViewControllerClass），但如果是手动调用logEvent(.screenView)或setScreenName时，主动传入了带模块/命名空间的全限定类名（如ModuleName.ViewControllerClass），就会出现这种格式。
• 模块化项目的区分需求：如果你的项目拆分成了多个模块（比如iOS的Swift Package、Android的feature模块），不同模块下可能存在同名的ViewController/Activity。这时Firebase在某些场景下会自动捕获全限定类名，用来区分这些同名组件，避免数据混淆。
• 平台特定API行为：比如Android中，Activity的全限定类名是默认追踪的标准格式；而iOS中，Swift类的String(describing:)方法会返回带模块名的全限定名，如果手动追踪时用了这个方法获取类名，就会上报全限定格式。

二、为什么会同时出现全限定与非全限定的重复统计？ #

这种重复是因为同一个屏幕被以两种不同的screen_class值上报了，常见原因包括：

• 混合使用自动和手动追踪：比如某个ViewController既被Firebase自动捕获了简单类名，同时你又在代码里手动调用setScreenClass传入了全限定名，这就会生成两条不同的screen_view事件记录，报表里自然会分开统计。
• 代码迭代中的格式不一致：如果项目在不同版本中，对screen_class的设置方式变了——比如之前用简单类名，后来改成全限定名，新旧版本的用户数据会同时出现在报表里，导致重复条目。
• 第三方SDK的干扰：如果项目集成了其他分析类SDK（比如埋点工具、广告SDK），它们可能也会触发screen_view事件，并且上报了不同格式的类名，和Firebase的追踪数据叠加后就会出现重复。
• 类名获取方式的差异：比如iOS中，获取类名的方式有self.className（不带模块）和String(describing: type(of: self))（带模块），如果不同地方用了不同方式，就会上报不同的类名。

解决建议 #

如果想统一报表格式、消除重复，可以试试这些方法：

• 统一screen_class格式：确定好使用全限定还是简单类名，然后在所有手动追踪的地方保持一致。比如iOS中可以封装一个工具方法，统一返回你想要的类名格式。
• 协调自动与手动追踪：如果不需要手动追踪，关闭手动上报的代码；如果必须手动控制，可以关闭Firebase的自动屏幕追踪（iOS：FirebaseAnalyticsConfiguration.shared().setAutoScreenReportingEnabled(false)；Android：在AndroidManifest.xml中设置firebase_analytics_auto_screen_reporting_enabled="false"），完全由手动代码控制上报。
• 排查第三方SDK：检查其他集成的SDK是否也在上报屏幕事件，调整它们的设置，避免和Firebase的追踪冲突。
• 筛选报表数据：如果是历史版本导致的重复，可以在Firebase报表中通过版本号筛选，只查看当前版本的数据，或者等旧数据自然过期（Firebase报表数据会保留一定时间后归档）。

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