評估畫面瀏覽

Google Analytics 會追蹤畫面轉場,並將目前畫面的相關資訊附加至事件,讓您追蹤使用者參與度或每個畫面的使用者行為等指標。這類資料收集作業大多會自動執行,但您也可以手動記錄螢幕檢視次數。如果應用程式未針對每個您想追蹤的畫面 (例如遊戲中的畫面) 使用個別的 UIViewControllerViewActivity,手動追蹤畫面就很實用。

自動追蹤螢幕

Analytics 會自動追蹤應用程式中某些畫面相關資訊,例如目前聚焦的 UIViewControllerActivity 的類別名稱。畫面轉換發生時,Analytics 會記錄 screen_view 事件,用於識別新畫面。在這些畫面上發生的事件會自動加上參數 firebase_screen_class (例如 menuViewControllerMenuActivity) 和產生的 firebase_screen_id。如果應用程式為每個畫面使用不同的 UIViewControllerActivityAnalytics 就能自動追蹤每個畫面轉換,並產生使用者參與度報表,並依畫面細分。如果您的應用程式沒有提供這類資料,您仍可透過手動記錄 screen_view 事件來取得這些報表。

停用螢幕檢視追蹤

如要在 iOS 上關閉自動回報螢幕檢視次數功能,請在 Info.plist 中將 FirebaseAutomaticScreenReportingEnabled 設為 NO (布林值)。

在 Android 上,請在 AndroidManifest.xml 檔案的 <application> 標記中巢狀設定以下設定:

<meta-data android:name="google_analytics_automatic_screen_reporting_enabled" android:value="false" />

手動追蹤螢幕

無論是否啟用自動追蹤功能,您都可以手動記錄 screen_view 事件。您可以在 Apple 平台的 onAppearviewDidAppear 方法,以及 Android 的 onResume 中記錄這些事件。如未設定 screen_classAnalytics 會根據呼叫時焦點所在的 UIViewController 或 Activity 設定預設值。

如果您已在應用程式中停用 swizzling,則必須手動設定所有畫面名稱。如果您是 SwiftUI 使用者,請使用 Analytics Swift 擴充功能 SDK

Swift

注意:這項 Firebase 產品不適用於 macOS 目標。
Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                                AnalyticsParameterScreenClass: screenClass])

Objective-C

注意:這項 Firebase 產品不適用於 macOS 目標。
[FIRAnalytics logEventWithName:kFIREventScreenView
                    parameters:@{kFIRParameterScreenClass: screenClass,
                                 kFIRParameterScreenName: screenName}];

Kotlin

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SCREEN_VIEW) {
    param(FirebaseAnalytics.Param.SCREEN_NAME, screenName)
    param(FirebaseAnalytics.Param.SCREEN_CLASS, "MainActivity")
}

Java

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.SCREEN_NAME, screenName);
bundle.putString(FirebaseAnalytics.Param.SCREEN_CLASS, "MainActivity");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SCREEN_VIEW, bundle);

Web

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'screen_view', {
  firebase_screen: screenName, 
  firebase_screen_class: screenClass
});

Web

firebase.analytics().logEvent('screen_view', {
  firebase_screen: screenName, 
  firebase_screen_class: screenClass
});

Dart

await FirebaseAnalytics.instance.logEvent(
  name: 'screen_view',
  parameters: {
    'firebase_screen': screenName,
    'firebase_screen_class': screenClass,
  },
);