วัดการดูหน้าจอ

Google Analytics จะติดตามการเปลี่ยนหน้าจอและแนบข้อมูลเกี่ยวกับหน้าจอปัจจุบันกับเหตุการณ์ ซึ่งช่วยให้คุณติดตามเมตริกต่างๆ เช่น การมีส่วนร่วมของผู้ใช้หรือพฤติกรรมของผู้ใช้ต่อหน้าจอได้ การเก็บรวบรวมข้อมูลส่วนใหญ่นี้จะเกิดขึ้นโดยอัตโนมัติ แต่คุณก็สามารถบันทึกการดูหน้าจอด้วยตนเองได้เช่นกัน การติดตามหน้าจอด้วยตนเองจะมีประโยชน์หากแอปของคุณไม่ได้ใช้ UIViewController, View หรือ Activity แยกต่างหากสำหรับแต่ละหน้าจอที่คุณอาจต้องการติดตาม เช่น ในเกม

ติดตามหน้าจอโดยอัตโนมัติ

Analytics จะติดตามข้อมูลบางอย่างเกี่ยวกับหน้าจอในแอปพลิเคชันโดยอัตโนมัติ เช่น ชื่อคลาสของ UIViewController หรือ Activity ที่กำลังโฟกัสอยู่ เมื่อเกิดการเปลี่ยนหน้าจอ Analytics จะบันทึกเหตุการณ์ screen_view ที่ระบุหน้าจอใหม่ เหตุการณ์ที่เกิดขึ้นในหน้าจอเหล่านี้จะได้รับการติดแท็กโดยอัตโนมัติด้วยพารามิเตอร์ firebase_screen_class (เช่น menuViewController หรือ MenuActivity) และ firebase_screen_id ที่สร้างขึ้น หากแอปใช้ UIViewController หรือ Activity ที่แตกต่างกันสำหรับแต่ละหน้าจอ Analytics จะติดตามการเปลี่ยนหน้าจอทุกครั้งและสร้างรายงานการมีส่วนร่วมของผู้ใช้ที่แยกตามหน้าจอได้โดยอัตโนมัติ หากแอปของคุณไม่ได้ใช้ คุณยังคงรับรายงานเหล่านี้ได้โดยการบันทึกเหตุการณ์ screen_view ด้วยตนเอง

ปิดใช้การติดตามการดูหน้าจอ

คุณปิดการรายงานการดูหน้าจออัตโนมัติใน iOS ได้โดยตั้งค่า FirebaseAutomaticScreenReportingEnabled เป็น NO (บูลีน) ใน Info.plist

และใน Android ให้ฝังการตั้งค่าต่อไปนี้ไว้ในแท็ก <application> ของไฟล์ AndroidManifest.xml

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

ติดตามหน้าจอด้วยตนเอง

คุณสามารถบันทึกเหตุการณ์ screen_view ด้วยตนเองได้ ไม่ว่าจะเปิดใช้การติดตามอัตโนมัติหรือไม่ก็ตาม คุณสามารถบันทึกเหตุการณ์เหล่านี้ในเมธอด onAppear หรือ viewDidAppear สำหรับแพลตฟอร์ม Apple และ onResume สำหรับ Android เมื่อไม่ได้ตั้งค่า screen_class ไว้ Analytics จะตั้งค่าเริ่มต้นตาม UIViewController หรือ Activity ที่โฟกัสอยู่เมื่อมีการเรียกใช้

หากคุณปิดใช้ Swizzling ในแอป คุณต้องตั้งชื่อหน้าจอทั้งหมดด้วยตนเอง สําหรับผู้ใช้ 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,
  },
);