Google Analytics suit les transitions d'écran et associe des informations sur l'écran actuel aux événements, ce qui vous permet de suivre des métriques telles que l'engagement ou le comportement des utilisateurs par écran. La plupart de ces données sont collectées automatiquement, mais vous pouvez également enregistrer manuellement les vues d'écran. Le suivi manuel des écrans est utile si votre application n'utilise pas de UIViewController
, View
ou Activity
distincts pour chaque écran que vous souhaitez suivre, par exemple dans un jeu.
Suivi automatique des écrans
Analytics suit automatiquement certaines informations sur les écrans de votre application, telles que le nom de la classe de l'UIViewController
ou de l'Activity
actuellement actif. Lorsqu'une transition d'écran se produit, Analytics consigne un événement screen_view
qui identifie le nouvel écran. Les événements qui se produisent sur ces écrans sont automatiquement tagués avec le paramètre firebase_screen_class
(par exemple, menuViewController
ou MenuActivity
) et un firebase_screen_id
généré. Si votre application utilise un UIViewController
ou un Activity
distinct pour chaque écran, Analytics peut suivre automatiquement chaque transition d'écran et générer un rapport sur l'engagement des utilisateurs, ventilé par écran. Si ce n'est pas le cas, vous pouvez toujours obtenir ces rapports en enregistrant manuellement les événements screen_view
.
Désactiver le suivi des vues d'écran
Vous pouvez désactiver la création automatique de rapports sur les vues d'écran sur iOS en définissant FirebaseAutomaticScreenReportingEnabled
sur NO
(booléen) dans le fichier Info.plist.
Sur Android, imbriquez le paramètre suivant dans la balise <application>
du fichier AndroidManifest.xml
:
<meta-data android:name="google_analytics_automatic_screen_reporting_enabled" android:value="false" />
Suivre manuellement les écrans
Vous pouvez enregistrer manuellement des événements screen_view
, que le suivi automatique soit activé ou non. Vous pouvez enregistrer ces événements dans les méthodes onAppear
ou viewDidAppear
pour les plates-formes Apple et onResume
pour Android. Lorsque screen_class
n'est pas défini, Analytics définit une valeur par défaut en fonction du UIViewController ou de l'activité en cours d'exécution lorsque l'appel est effectué.
Si vous avez désactivé le mélange dans votre application, tous les noms d'écran doivent être définis manuellement. Pour les utilisateurs de SwiftUI, utilisez le SDK d'extension Swift Analytics.
Swift
Analytics.logEvent(AnalyticsEventScreenView, parameters: [AnalyticsParameterScreenName: screenName, AnalyticsParameterScreenClass: screenClass])
Objective-C
[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,
},
);