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 平台和 Android 適用的 onResume
,您可以在 onAppear
或 viewDidAppear
方法中記錄這些事件。如未設定 screen_class
,Analytics (分析) 會根據呼叫時聚焦的 UIViewController 或活動,設定預設值。
如果您已停用應用程式中的滑動功能,則必須手動設定所有畫面名稱。如果是 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,
},
);