Google Analytics, ekran geçişlerini izler ve mevcut ekranla ilgili bilgileri etkinliklere ekleyerek ekran başına kullanıcı etkileşimi veya kullanıcı davranışı gibi metrikleri izlemenizi sağlar. Bu veri toplama işleminin çoğu otomatik olarak gerçekleşir ancak ekran görüntülemelerini manuel olarak da kaydedebilirsiniz. Uygulamanız, izlemek isteyebileceğiniz her ekran için ayrı bir UIViewController, View veya Activity kullanmıyorsa (ör. bir oyunda) ekranları manuel olarak izlemek yararlı olur.
Ekranları otomatik olarak izleme
Analytics, uygulamanızdaki ekranlarla ilgili bazı bilgileri (ör. şu anda odakta olan UIViewController veya Activity öğesinin sınıf adı) otomatik olarak izler. Ekran geçişi gerçekleştiğinde Analytics, yeni ekranı tanımlayan bir screen_view etkinliği kaydeder. Bu ekranlarda gerçekleşen etkinlikler, firebase_screen_class parametresiyle (örneğin, menuViewController veya MenuActivity) ve oluşturulan firebase_screen_id ile otomatik olarak etiketlenir. Uygulamanız her ekran için farklı bir UIViewController veya Activity kullanıyorsa Analytics her ekran geçişini otomatik olarak izleyebilir ve kullanıcı etkileşiminin ekrana göre dökümünü içeren bir rapor oluşturabilir. Uygulamanız bu raporları desteklemiyorsa screen_view etkinliklerini manuel olarak günlüğe kaydederek yine de bu raporları alabilirsiniz.
Ekran görüntüleme izlemeyi devre dışı bırakma
Otomatik ekran görüntüleme raporlaması, Info.plist'te FirebaseAutomaticScreenReportingEnabled değeri NO (Boolean) olarak ayarlanarak iOS'te devre dışı bırakılabilir.
Android'de ise aşağıdaki ayarı AndroidManifest.xml dosyasının <application> etiketi içine yerleştirin:
<meta-data android:name="google_analytics_automatic_screen_reporting_enabled" android:value="false" />
Ekranları manuel olarak izleme
Otomatik izleme etkin olsun veya olmasın screen_view etkinliklerini manuel olarak kaydedebilirsiniz. Bu etkinlikleri Apple platformları için onAppear veya viewDidAppear yöntemleriyle, Android için ise onResume yöntemiyle günlüğe kaydedebilirsiniz. screen_class ayarlanmadığında,
Analytics, çağrı yapıldığında odaklanılan UIViewController veya Activity'ye göre varsayılan bir değer ayarlar.
Uygulamanızda karıştırmayı devre dışı bıraktıysanız tüm ekran adları manuel olarak ayarlanmalıdır. SwiftUI kullanıcıları Analytics Swift uzantısı SDK'sını kullanmalıdır.
Swift
Analytics.logEvent(AnalyticsEventScreenView, parameters: [AnalyticsParameterScreenName: screenName, AnalyticsParameterScreenClass: screenClass])
Objective-C
[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,
},
);