מדידת צפיות במסך

Google Analytics עוקב אחרי מעברים בין מסכים ומצרף מידע על המסך הנוכחי לאירועים, וכך מאפשר לכם לעקוב אחרי מדדים כמו מעורבות משתמשים או התנהגות משתמשים בפילוח לפי מסך. חלק גדול מאיסוף הנתונים הזה מתבצע באופן אוטומטי, אבל אתם יכולים גם לתעד צפיות במסך באופן ידני. מעקב ידני אחרי מסכים שימושי אם האפליקציה לא משתמשת ב-UIViewController, ב-View או ב-Activity נפרדים לכל מסך שרוצים לעקוב אחריו, כמו במשחק.

מעקב אוטומטי אחרי מסכים

Analytics עוקב באופן אוטומטי אחרי חלק מהמידע על המסכים באפליקציה, כמו שם המחלקה של UIViewController או Activity שמוצגים כרגע. כשמתרחש מעבר בין מסכים, Analytics מתעד אירוע screen_view שמזהה את המסך החדש. אירועים שמתרחשים במסכים האלה מתויגים באופן אוטומטי בפרמטר firebase_screen_class (לדוגמה, menuViewController או MenuActivity) ובערך firebase_screen_id שנוצר. אם האפליקציה משתמשת ב-UIViewController או ב-Activity נפרדים לכל מסך, Analytics יכול לעקוב באופן אוטומטי אחרי כל מעבר בין מסכים וליצור דוח של מעורבות המשתמשים, עם פירוט לפי מסך. אם האפליקציה לא משתמשת ב-UIViewController או ב-Activity נפרדים לכל מסך, עדיין אפשר לקבל את הדוחות האלה על ידי רישום ידני של אירועי screen_view.

השבתת מעקב אחר צפיות במסך

כדי להשבית את הדיווח האוטומטי על צפיות במסך ב-iOS, צריך להגדיר את FirebaseAutomaticScreenReportingEnabled ל-NO (Boolean) בקובץ Info.plist.

ב-Android, מקננים את ההגדרה הבאה בתג <application> של הקובץ AndroidManifest.xml:

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

מעקב ידני אחרי מסכים

אתם יכולים לתעד אירועים של screen_view באופן ידני, גם אם הפעלתם מעקב אוטומטי וגם אם לא. אפשר לתעד את האירועים האלה בשיטות onAppear או viewDidAppear לפלטפורמות של אפל ובשיטה onResume ל-Android. אם לא מגדירים את screen_class,‏ Analytics מגדיר ערך ברירת מחדל על סמך ה-UIViewController או הפעילות שנמצאים במוקד כשהשיחה מתבצעת.

אם השבתתם את ההחלפה באפליקציה, צריך להגדיר את כל שמות המסכים באופן ידני. משתמשי SwiftUI צריכים להשתמש ב-Analytics Swift extension SDK.

Swift

הערה: מוצר Firebase הזה לא זמין ביעד watchOS.
Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                               AnalyticsParameterScreenClass: screenClass])

Objective-C

הערה: מוצר Firebase הזה לא זמין ביעד 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,
  },
);