Firebase is back at Google I/O on May 10! Register now

Mesurer les vues d'écran

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Google Analytics suit les transitions d'écran et joint des informations sur l'écran actuel aux événements, vous permettant de suivre des mesures telles que l'engagement des utilisateurs ou le comportement des utilisateurs par écran. Une grande partie de cette collecte de données se fait automatiquement, mais vous pouvez également enregistrer manuellement les vues d'écran. Le suivi manuel des écrans est utile si votre application n'utilise pas un UIViewController , View ou Activity distinct pour chaque écran que vous souhaitez suivre, comme dans un jeu.

Suivre automatiquement les écrans

Analytics suit automatiquement certaines informations sur les écrans de votre application, telles que le nom de classe du UIViewController ou Activity actuellement ciblée. 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 marqué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 Activity distincte 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 votre application ne le fait pas, vous pouvez toujours obtenir ces rapports en enregistrant manuellement les événements screen_view .

Désactiver le suivi de la vue d'écran

La création de rapports automatiques sur les vues d'écran peut être désactivée sur iOS en définissant FirebaseAutomaticScreenReportingEnabled sur NO (booléen) dans Info.plist.

Et 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 consigner manuellement les é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. Lorsque screen_class n'est pas défini, Analytics définit une valeur par défaut basée sur le UIViewController ou l'activité qui est en focus 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 SDK d'extension Analytics Swift .

Rapide

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

Objectif c

Remarque : Ce produit Firebase n'est pas disponible sur la cible macOS.
[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 version 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'screen_view', {
  firebase_screen: screenName, 
  firebase_screen_class: screenClass
});

Web version 8

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,
  },
);