iOS应用Firebase Analytics自动日志失效（screen_view未统计）求助

原因说明 #

Firebase Analytics在iOS上默认不会自动追踪所有ViewController的页面浏览事件，需要额外配置或手动埋点才能触发自动的screen_view事件。

修复方案 #

方案1：启用全局自动页面追踪（推荐） #

在项目的Info.plist中添加配置项，让Firebase自动识别ViewController的页面切换：

1. 打开Info.plist文件
2. 添加键FirebaseAutomaticScreenReportingEnabled，类型设为Boolean，值设为YES

方案2：单个ViewController手动触发事件 #

如果不需要全局启用，或者需要给特定页面自定义参数，可在目标ViewController的viewDidAppear:方法中手动上报：

// Objective-C 示例
- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    [FIRAnalytics logEventWithName:kFIREventScreenView parameters:@{
        kFIRParameterScreenName: NSStringFromClass([self class]),
        kFIRParameterScreenClass: NSStringFromClass([self class])
    }];
}

// Swift 示例
override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    Analytics.logEvent(AnalyticsEventScreenView, parameters: [
        AnalyticsParameterScreenName: String(describing: type(of: self)),
        AnalyticsParameterScreenClass: String(describing: type(of: self))
    ])
}

方案3：用分类/扩展统一处理所有ViewController #

如果要给所有ViewController统一添加上报逻辑，可创建全局分类/扩展：

// Objective-C 分类
#import <UIKit/UIKit.h>
#import <FirebaseAnalytics/FirebaseAnalytics.h>

@interface UIViewController (FirebaseScreenTracking)
@end

@implementation UIViewController (FirebaseScreenTracking)

- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    // 排除导航栏、标签栏控制器避免重复上报
    if (![self isKindOfClass:[UINavigationController class]] && ![self isKindOfClass:[UITabBarController class]]) {
        [FIRAnalytics logEventWithName:kFIREventScreenView parameters:@{
            kFIRParameterScreenName: NSStringFromClass([self class]),
            kFIRParameterScreenClass: NSStringFromClass([self class])
        }];
    }
}

@end

// Swift 扩展
import UIKit
import FirebaseAnalytics

extension UIViewController {
    open override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        // 排除导航栏、标签栏控制器避免重复上报
        if !(self is UINavigationController) && !(self is UITabBarController) {
            Analytics.logEvent(AnalyticsEventScreenView, parameters: [
                AnalyticsParameterScreenName: String(describing: type(of: self)),
                AnalyticsParameterScreenClass: String(describing: type(of: self))
            ])
        }
    }
}

验证方法 #

配置完成后，可通过两种方式验证：

• 打开Firebase控制台的Analytics模块，等待10-30分钟（数据存在延迟），查看screen_view事件的新增数据
• 使用Xcode的Debug View功能，实时查看事件上报情况

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