Google Analytics 會追蹤畫面轉場,並將目前畫面的相關資訊附加至事件,讓您追蹤使用者參與度或每個畫面的使用者行為等指標。系統會自動收集大部分的資料,但您也可以手動記錄螢幕檢視次數。如果應用程式未針對每個您想追蹤的畫面 (例如遊戲) 使用個別的 UIViewController
、View
或 Activity
,手動追蹤畫面就很實用。
自動追蹤螢幕
Analytics 會自動追蹤應用程式中某些畫面相關資訊,例如目前焦點所在的 UIViewController
或 Activity
的類別名稱。畫面轉換發生時,Analytics 會記錄 screen_view
事件,用於識別新畫面。在這些畫面上發生的事件會自動加上參數 firebase_screen_class
(例如 menuViewController
或 MenuActivity
) 和產生的 firebase_screen_id
。如果應用程式為每個畫面使用不同的 UIViewController
或 Activity
,Analytics 就能自動追蹤每個畫面轉換,並產生使用者參與度報表,並依畫面細分。如果您的應用程式沒有提供這類資料,您仍可透過手動記錄 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 平台的 onAppear
或 viewDidAppear
方法,以及 Android 的 onResume
中記錄這些事件。如果未設定 screen_class
,Analytics 會根據呼叫時焦點所在的 UIViewController 或 Activity 設定預設值。
如果您已在應用程式中停用 swizzling,則必須手動設定所有畫面名稱。如果是 SwiftUI 使用者,請使用 Analytics Swift 擴充功能 SDK。
Swift
Analytics.logEvent(AnalyticsEventScreenView, parameters: [AnalyticsParameterScreenName: screenName, AnalyticsParameterScreenClass: screenClass])
Objective-C
[FIRAnalytics logEventWithName:kFIREventScreenView parameters:@{kFIRParameterScreenClass: screenClass, kFIRParameterScreenName: screenName}];
Kotlin+KTX
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,
},
);