Cette page a été traduite par l'API Cloud Translation.
Switch to English

Commencez avec Google Analytics

Ce guide de démarrage rapide vous montre comment ajouter Google Analytics à votre application et commencer à enregistrer les événements.

Google Analytics collecte des données d'utilisation et de comportement pour votre application Web. Le SDK enregistre deux principaux types d'informations:

  • Événements : ce qui se passe dans votre application, comme les actions des utilisateurs, les événements système ou les erreurs.

  • Propriétés utilisateur : attributs que vous définissez pour décrire des segments de votre base d'utilisateurs, tels que la préférence de langue ou l'emplacement géographique.

Analytics enregistre automatiquement certains événements et propriétés des utilisateurs ; vous n'avez pas besoin d'ajouter de code pour les activer.

Avant que tu commences

Si vous ne l'avez pas déjà fait, ajoutez Firebase à votre projet JavaScript et assurez-vous que Google Analytics est activé dans votre projet Firebase:

  • Si vous créez un nouveau projet Firebase, activez Google Analytics pendant le processus de création de projet.

  • Si vous disposez d'un projet Firebase existant pour lequel Google Analytics n'est pas activé, vous pouvez activer Google Analytics à partir de l'onglet Intégrations de vos > Paramètres du projet .

Lorsque vous activez Google Analytics dans votre projet, vos applications Web Firebase sont liées aux flux de données Google Analytics associés à une propriété Application + Web .

Ajoutez le SDK Analytics à votre application

Selon la manière dont votre application Web est hébergée, votre configuration peut être gérée automatiquement ou vous devrez peut-être mettre à jour votre objet de configuration Firebase . Si votre application Web utilise déjà Google Analytics, vous devrez peut-être effectuer une configuration supplémentaire décrite dans Utiliser Firebase avec le balisage gtag.js existant .

  1. Vérifiez que votre objet de configuration Firebase dans votre code contient measurementId . Cet ID est automatiquement créé lorsque vous activez Analytics dans votre projet Firebase et enregistrez une application Web, et il est nécessaire pour utiliser Analytics.

    • Si votre application utilise Firebase Hosting et utilise des URL réservées pour les SDK Firebase :

      Firebase gère automatiquement la configuration de votre application. Pour terminer la configuration, ajoutez les scripts de la carte Vos applications dans les paramètres de votre projet à la balise <body> de votre application, si vous ne l'avez pas déjà fait.

    • Si votre application n'utilise pas d'URL réservées : si vous travaillez avec une application Web existante , mettez à jour l'objet de configuration Firebase dans votre code pour vous assurer que le champ measurementId est présent. L'objet de configuration doit ressembler à l'exemple suivant:

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
      const firebaseConfig = {
        apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc",
        authDomain: "project-id.firebaseapp.com",
        databaseURL: "https://project-id.firebaseio.com",
        projectId: "project-id",
        storageBucket: "project-id.appspot.com",
        messagingSenderId: "637908496727",
        appId: "2:637908496727:web:a4284b4c99e329d5",
        measurementId: "G-9VP01NDSXJ"
      };
      
  2. Initialisez Firebase Analytics:

     firebase.analytics();
    

Utiliser Firebase avec le balisage gtag.js existant

Si Google Analytics était précédemment exécuté dans votre application à l'aide de l' extrait gtag.js , votre application peut nécessiter une configuration supplémentaire si vous prévoyez d'effectuer l'une des opérations suivantes:

  • Ajoutez les appels Google Analytics de Firebase à la page, mais prévoyez également de continuer à utiliser les gtag() directement sur la même page.
  • Vous souhaitez utiliser le même ID de mesure entre les gtag() directs gtag() et les données Google Analytics envoyées à Firebase.

Pour vous assurer que vos événements sont disponibles pour être utilisés par tous les services Firebase, effectuez les étapes de configuration supplémentaires suivantes:

  • Supprimez [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) dans l'URL. Votre extrait de code gtag doit être similaire à

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • Supprimez la ligne gtag('config', ' GA_MEASUREMENT_ID '); où le GA_MEASUREMENT_ID est le même que le measurementId dans votre extrait Firebase config. Si vous avez d'autres identifiants pour d'autres propriétés Analytics sur la page, vous n'avez pas besoin de supprimer leur ligne de configuration.

  • Assurez-vous d'appeler firebase.analytics() avant d'envoyer des événements avec gtag() .

Sinon, les événements envoyés à cet ID avec des gtag() ne seront pas associés à Firebase et ne seront pas disponibles pour le ciblage dans d'autres services Firebase.

Commencer la journalisation des événements

Après avoir initialisé le service Analytics avec «firebase.analytics ()» , vous pouvez commencer à consigner les événements avec la méthode «logEvent ()» .

Certains événements sont recommandés pour toutes les applications ; d'autres sont recommandés pour des types d'entreprises ou des secteurs verticaux spécifiques. Vous devez envoyer des suggestions d'événements avec leurs paramètres prescrits, pour garantir un maximum de détails disponibles dans vos rapports et pour bénéficier des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section montre la journalisation d'un événement prédéfini, pour plus d'informations sur la journalisation des événements, voir Journaliser les événements .

L'exemple suivant montre comment consigner un événement recommandé pour indiquer qu'un utilisateur a reçu une notificationt dans votre application:

firebase.analytics().logEvent('notification_received');

Prochaines étapes