Google Analytics theo dõi các lượt chuyển đổi màn hình và đính kèm thông tin về màn hình hiện tại vào các sự kiện, cho phép bạn theo dõi các chỉ số như mức độ tương tác của người dùng hoặc hành vi của người dùng trên mỗi màn hình. Hầu hết hoạt động thu thập dữ liệu này đều diễn ra tự động, nhưng bạn cũng có thể ghi lại số lượt xem màn hình theo cách thủ công. Việc theo dõi màn hình theo cách thủ công sẽ hữu ích nếu ứng dụng của bạn không sử dụng UIViewController
, View
hoặc Activity
riêng biệt cho mỗi màn hình mà bạn muốn theo dõi, chẳng hạn như trong trò chơi.
Tự động theo dõi màn hình
Analytics tự động theo dõi một số thông tin về màn hình trong ứng dụng, chẳng hạn như tên lớp của UIViewController
hoặc Activity
hiện đang được lấy làm tâm điểm. Khi quá trình chuyển đổi màn hình xảy ra, Analytics sẽ ghi lại một sự kiện screen_view
xác định màn hình mới. Các sự kiện xảy ra trên các màn hình này sẽ tự động được gắn thẻ bằng thông số firebase_screen_class
(ví dụ: menuViewController
hoặc MenuActivity
) và một firebase_screen_id
được tạo. Nếu ứng dụng của bạn sử dụng một UIViewController
hoặc Activity
riêng biệt cho mỗi màn hình, thì Analytics có thể tự động theo dõi mọi lượt chuyển đổi màn hình và tạo báo cáo về mức độ tương tác của người dùng theo màn hình. Nếu ứng dụng của bạn không có, bạn vẫn có thể nhận được các báo cáo này bằng cách ghi lại sự kiện screen_view
theo cách thủ công.
Tắt tính năng theo dõi lượt xem màn hình
Bạn có thể tắt tính năng báo cáo lượt xem màn hình tự động trên iOS bằng cách đặt
FirebaseAutomaticScreenReportingEnabled
thành NO
(Boolean) trong Info.plist.
Và trên Android, hãy lồng chế độ cài đặt sau đây trong thẻ <application>
của tệp AndroidManifest.xml
:
<meta-data android:name="google_analytics_automatic_screen_reporting_enabled" android:value="false" />
Theo dõi màn hình theo cách thủ công
Bạn có thể ghi nhật ký sự kiện screen_view
theo cách thủ công, cho dù tính năng theo dõi tự động có được bật hay không. Bạn có thể ghi lại những sự kiện này trong phương thức onAppear
hoặc viewDidAppear
cho các nền tảng của Apple và onResume
cho Android. Khi bạn không đặt screen_class
, Analytics sẽ đặt giá trị mặc định dựa trên UIViewController hoặc Hoạt động đang được đặt làm tiêu điểm khi thực hiện lệnh gọi.
Nếu bạn đã tắt tính năng xáo trộn trong ứng dụng, bạn phải đặt tất cả tên màn hình theo cách thủ công. Đối với người dùng SwiftUI, hãy sử dụng Analytics SDK tiện ích Swift.
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,
},
);