Mesurer les vues d'écran

Google Analytics effectue le suivi des 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 d'élément UIViewController, View ou Activity distinct pour chaque écran que vous souhaitez suivre, comme dans un jeu.

Suivre automatiquement les écrans

Analytics effectue automatiquement le suivi de certaines informations sur les écrans de votre application, telles que le nom de la classe de l'UIViewController ou de l'Activity actuellement active. 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 utilisateur, ventilé par écran. Si ce n'est pas le cas, vous pouvez toujours obtenir ces rapports en consignant manuellement les événements screen_view.

Désactiver le suivi des vues d'écran

Vous pouvez désactiver le reporting automatique des 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 consigner ces événements dans les méthodes onAppear ou viewDidAppear pour les plates-formes Apple et onResume pour Android. Si screen_class n'est pas défini, Analytics définit une valeur par défaut basée sur l'UIViewController ou l'Activity qui est actif lorsque l'appel est effectué.

Si vous avez désactivé le swizzling dans votre application, tous les noms d'écran doivent être définis manuellement. Pour les utilisateurs de SwiftUI, utilisez le Analytics SDK d'extension Swift.

Swift

Remarque : Ce produit Firebase n'est pas disponible sur la cible watchOS. 
Analytics.logEvent(AnalyticsEventScreenView,
                   parameters: [AnalyticsParameterScreenName: screenName,
                               AnalyticsParameterScreenClass: screenClass])

Objective-C

Remarque : Ce produit Firebase n'est pas disponible sur la cible 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,
  },
);