Mengukur tampilan layar

Google Analytics melacak transisi layar dan melampirkan informasi tentang layar saat ini ke peristiwa, sehingga Anda dapat melacak metrik seperti interaksi pengguna atau perilaku pengguna per layar. Sebagian besar pengumpulan data ini terjadi secara otomatis, tetapi Anda juga dapat mencatat tampilan layar ke dalam log secara manual. Pelacakan layar secara manual berguna jika aplikasi Anda tidak menggunakan UIViewController, View, atau Activity terpisah untuk setiap layar yang ingin dilacak, seperti dalam game.

Melacak layar secara otomatis

Analytics secara otomatis melacak beberapa informasi terkait layar di aplikasi Anda, seperti nama class UIViewController atau Activity yang sedang menjadi fokus. Saat terjadi transisi layar, Analytics akan mencatat peristiwa screen_view yang mengidentifikasi layar baru. Peristiwa yang terjadi pada layar akan otomatis diberi tag dengan parameter firebase_screen_class (misalnya, menuViewController atau MenuActivity) dan firebase_screen_id yang dihasilkan. Jika aplikasi Anda menggunakan UIViewController atau Activity yang berbeda untuk setiap layar, Analytics dapat otomatis melacak setiap transisi layar dan membuat laporan interaksi pengguna yang dikelompokkan berdasarkan layar. Jika tidak, Anda masih bisa mendapatkan laporan ini dengan mencatat peristiwa screen_view ke dalam log secara manual.

Menonaktifkan pelacakan tampilan layar

Pelaporan tampilan layar otomatis dapat dinonaktifkan di iOS dengan menetapkan FirebaseAutomaticScreenReportingEnabled ke NO (Boolean) di Info.plist.

Dan di Android, tempatkan setelan berikut ke dalam tag <application> pada file AndroidManifest.xml:

<meta-data android:name="google_analytics_automatic_screen_reporting_enabled" android:value="false" />

Melacak layar secara manual

Anda dapat mencatat peristiwa screen_view ke dalam log secara manual, tanpa mempertimbangkan apakah pelacakan otomatis diaktifkan atau tidak. Anda dapat mencatat peristiwa ini ke dalam log dengan metode onAppear atau viewDidAppear untuk platform Apple dan onResume untuk Android. Jika screen_class tidak ditetapkan, Analytics akan menetapkan nilai default berdasarkan UIViewController atau Aktivitas yang menjadi fokus saat panggilan dibuat.

Jika Anda telah menonaktifkan swizzling di aplikasi, semua nama layar harus ditetapkan secara manual. Untuk pengguna SwiftUI, gunakan SDK ekstensi Swift Analytics.

Swift

Catatan: Produk Firebase ini tidak tersedia di target macOS.
Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                                AnalyticsParameterScreenClass: screenClass])

Objective-C

Catatan: Produk Firebase ini tidak tersedia di target macOS.
[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);

API modular web

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'screen_view', {
  firebase_screen: screenName, 
  firebase_screen_class: screenClass
});

API dengan namespace 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,
  },
);