.NET MAUI应用如何向GA4 Pages and Screens提供屏幕名称？

Plugin.Firebase完全支持GA4的屏幕视图统计功能，你看到的"Not Set"是因为没有主动上报screen_view事件并传递正确的屏幕名称参数。GA4的Pages and Screens报告依赖screen_view事件中的screen_name和screen_class参数来展示数据，具体实现步骤如下：

1. 核心实现：在页面生命周期中上报屏幕事件 #

在每个MAUI页面的OnAppearing方法中调用Firebase Analytics的事件上报接口，传递屏幕名称和类名参数：

using Plugin.Firebase.Analytics;

public partial class MainPage : ContentPage
{
    private bool _hasReportedScreenView;

    protected override void OnAppearing()
    {
        base.OnAppearing();
        
        // 避免页面重复出现时重复上报
        if (!_hasReportedScreenView)
        {
            FirebaseAnalytics.Current.LogEvent(
                FirebaseAnalytics.EventScreenView,
                new Dictionary<string, object>
                {
                    { FirebaseAnalytics.ParameterScreenName, "首页" }, // 自定义屏幕名称，比如"商品列表页"
                    { FirebaseAnalytics.ParameterScreenClass, nameof(MainPage) } // 页面类名，可选但建议传递
                });
            _hasReportedScreenView = true;
        }
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        // 页面消失时重置标记，确保下次重新出现时能再次上报
        _hasReportedScreenView = false;
    }
}

2. 关键参数说明 #

• FirebaseAnalytics.EventScreenView：GA4标准的屏幕视图事件名，必须使用这个事件名才能被Pages and Screens报告识别
• FirebaseAnalytics.ParameterScreenName：自定义的屏幕名称，这就是报告中会显示的名称，替换成你需要的业务名称即可
• FirebaseAnalytics.ParameterScreenClass：页面对应的类名，用于报告中的"屏幕类别"拆分，可选但能让数据维度更清晰

3. 注意事项 #

• 确保Plugin.Firebase的Analytics模块已正确初始化（你已经能发送其他事件，这一步应该没问题）
• GA4数据存在延迟，上报后可能需要1-2小时才能在Pages and Screens报告中看到更新
• 如果需要统一处理所有页面的上报，可以封装一个BasePage基类，将上报逻辑放在基类的OnAppearing中，所有业务页面继承该基类即可

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