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

Google Analytics theo dõi các hiệu ứng chuyển đổi màn hình và đính kèm thông tin về màn hình hiện tại cho các sự kiện, cho phép bạn theo dõi các chỉ số như người dùng mức độ tương tác 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ể tự ghi nhật ký lượt xem màn hình. Theo dõi thủ công sẽ hữu ích nếu ứng dụng của bạn không sử dụng UIViewController riêng biệt, View hoặc Activity cho mỗi màn hình mà bạn muốn theo dõi, chẳng hạn như trong một 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ề các 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à hiện đang được lấy làm tiêu điểm. Khi một sự kiện chuyển 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. Những sự kiện xảy ra trên được tự động gắn thẻ bằng thông số firebase_screen_class (cho ví dụ: menuViewController hoặc MenuActivity) và được tạo firebase_screen_id. Nếu ứng dụng của bạn sử dụng một UIViewController hoặc Activity cho mỗi màn hình, Analytics có thể tự động theo dõi mọ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 được chia nhỏ theo màn hình. Nếu ứng dụng của bạn không, bạn vẫn có thể nhận các báo cáo này bằng cách ghi nhật ký theo cách thủ công screen_view sự kiện.

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 tự động báo cáo lượt xem màn hình trên iOS bằng cách cài đặt FirebaseAutomaticScreenReportingEnabled đến NO (Boolean) trong tệp 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 lại các 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. 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 đặt giá trị mặc định dựa trên UIViewController hoặc Hoạt động được lấy tiêu điểm khi cuộc gọi được thực hiện.

Nếu đã tắt tính năng tạo nhanh trong ứng dụng của mình, 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ành cho macOS mục tiêu.
Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                                AnalyticsParameterScreenClass: screenClass])

Objective-C

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