Đo lường lượt xem màn hình

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. Phần lớn hoạt động thu thập dữ liệu này diễn ra tự động, nhưng bạn cũng có thể ghi lại 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 của bạn, chẳng hạn như tên lớp của UIViewController hoặc Activity mà người dùng hiện đang xem. Khi quá trình chuyển đổi màn hình diễn 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 những màn hình này sẽ tự động được gắn thẻ bằng tham số firebase_screen_class (ví dụ: menuViewController hoặc MenuActivity) và 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 tự động ghi nhật ký, bạn vẫn có thể nhận các báo cáo này bằng cách ghi nhật ký các 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.

Trên Android, hãy lồng chế độ cài đặt sau vào 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ý các sự kiện screen_view theo cách thủ công cho dù có bật tính năng theo dõi tự động hay không. Bạn có thể ghi lại các sự kiện này bằng phương thức onAppear hoặc viewDidAppear cho 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 lấy tiêu điểm khi lệnh gọi được thực hiện.

Nếu bạn đã tắt tính năng swizzling trong ứng dụng, thì 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

Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu watchOS. 
Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                               AnalyticsParameterScreenClass: screenClass])

Objective-C

Lưu ý: Sản phẩm Firebase này không dùng được trên mục tiêu watchOS. 
[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,
  },
);