Premiers pas 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: Qu'est - ce qui se passe dans votre application, telles que les actions de l' utilisateur, les événements du système ou des erreurs.

  • Propriétés de l' utilisateur: vous Attributs définissent pour décrire les segments de votre base d'utilisateurs, tels que les préférences linguistiques ou la situation géographique.

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

Avant que tu commences

Si vous avez pas déjà, 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 workflow de création de projet.

  • Si vous utilisez un projet existant qui ne Firebase pas Google Analytics activé, accédez à l' Intégrations onglet de vos > Paramètres du projet pour l' activer.

Lorsque vous activez Google Analytics dans votre projet, vos applications Web Firebase sont liées aux données Google Analytics avec un cours d' eau associés propriété Web App + .

Ajouter le SDK Analytics à votre application

Selon la façon dont votre application web est hébergé, votre configuration peut être gérée automatiquement ou vous devez mettre à jour votre objet de configuration Firebase . Si votre application Web utilise déjà Google Analytics, vous devrez peut - être faire une configuration supplémentaire décrite dans Utilisation Firebase avec marquage gtag.js existants .

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

    • Si votre application utilise Firebase Hébergement et utilisations des URL réservées pour la Firebase SDKs:

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

    • Si votre application ne pas utiliser les URL réservées: Si vous travaillez avec une application Web existante, mettre à jour l'objet config Firebase dans votre code pour assurer le measurementId champ 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 :

Web version 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

Web version 8

const analytics = firebase.analytics();

Utiliser Firebase avec le balisage gtag.js existant

Si vous avez déjà en cours d' exécution Google Analytics dans votre application en utilisant l' extrait de code gtag.js , votre application peut nécessiter une configuration supplémentaire si vous envisagez de faire une des opérations suivantes:

  • Ajouter appels Google Analytics de Firebase à la page mais prévoient également de continuer à utiliser gtag() appelle directement sur la même page.
  • Voulez -vous utiliser le même ID de mesure entre les deux directe gtag() des appels et des données Google Analytics envoyées à Firebase.

Pour vous assurer que vos événements peuvent être utilisés par tous les services Firebase, procédez comme suit :

  • Supprimez la ligne gtag('config', ' GA_MEASUREMENT_ID '); où le GA_MEASUREMENT_ID est le measurementId de votre application web Firebase. Si vous avez d'autres ID pour d'autres propriétés Analytics sur la page, vous n'avez pas besoin de supprimer leur ligne de configuration.
  • Assurez - vous que vous appelez firebase.analytics() avant d'envoyer des événements avec gtag() .

Dans le cas contraire, les événements envoyés à cet ID avec gtag() les appels ne seront pas associés à Firebase et ne seront pas disponibles pour le ciblage dans les autres services Firebase.

Démarrer la journalisation des événements

Après avoir initialisé le service de logEvent() Google Analytics , vous pouvez commencer à enregistrer des événements avec le logEvent() méthode.

Certains événements sont recommandés pour toutes les applications ; d'autres sont recommandés pour des types d'entreprise ou des secteurs verticaux spécifiques. Vous devez envoyer des suggestions d'événements avec leurs paramètres prescrits, afin d'assurer un maximum de détails disponibles dans vos rapports et de bénéficier des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section explique la connexion d' un événement défini avant, pour plus d' informations sur l'enregistrement des événements, voir les événements du journal .

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

Web version 9

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Web version 8

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

Prochaines étapes