Iniziare a utilizzare Google Analytics

Questa guida rapida ti mostra come aggiungere Google Analytics alla tua app e iniziare a registrare gli eventi.

Google Analytics raccoglie dati sull'utilizzo e sul comportamento della tua app web. L'SDK registra due tipi principali di informazioni:

  • Eventi : cosa sta succedendo nella tua app, come azioni dell'utente, eventi di sistema o errori.

  • Proprietà utente : attributi che definisci per descrivere segmenti della tua base utenti, come la preferenza della lingua o la posizione geografica.

Analytics registra automaticamente alcuni eventi e proprietà dell'utente ; non è necessario aggiungere alcun codice per abilitarli.

Prima di iniziare

Se non l'hai già fatto, aggiungi Firebase al tuo progetto JavaScript e assicurati che Google Analytics sia abilitato nel tuo progetto Firebase:

  • Se stai creando un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.

  • Se utilizzi un progetto Firebase esistente su cui non è abilitato Google Analytics, vai alla scheda Integrazioni del tuo > Impostazioni progetto per abilitarlo.

Quando abiliti Google Analytics nel tuo progetto, le tue app web Firebase vengono collegate ai flussi di dati di Google Analytics associati a una proprietà App + Web .

Aggiungi l'SDK di Analytics alla tua app

A seconda della modalità di hosting della tua applicazione web, la configurazione potrebbe essere gestita automaticamente oppure potrebbe essere necessario aggiornare l' oggetto di configurazione Firebase . Se la tua app web utilizza già Google Analytics, potrebbe essere necessario eseguire una configurazione aggiuntiva descritta in Utilizzare Firebase con il tagging gtag.js esistente .

  1. Verifica che l'oggetto di configurazione Firebase nel codice contenga measurementId . Questo ID viene creato automaticamente quando abiliti Analytics nel tuo progetto Firebase e registri un'app Web ed è necessario per utilizzare Analytics.

    • Se la tua app utilizza Firebase Hosting e utilizza URL riservati per gli SDK Firebase :

      Firebase gestisce automaticamente la configurazione della tua applicazione. Per completare la configurazione, aggiungi gli script dalla scheda Le tue app nelle impostazioni del progetto al tag <body> della tua app, se non lo hai già fatto.

    • Se la tua app non utilizza URL riservati : se lavori con un'app web esistente , aggiorna l'oggetto di configurazione Firebase nel tuo codice per assicurarti che il campo measurementId sia presente. L'oggetto di configurazione dovrebbe essere simile al seguente esempio:

      // 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. Se non lo hai già fatto, installa Firebase JS SDK e inizializza Firebase .

  3. Aggiungi l'SDK Analytics JS e inizializza Analytics:

API modulare Web

import { initializeApp } from "firebase/app";
import { getAnalytics } from "firebase/analytics";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Analytics and get a reference to the service
const analytics = getAnalytics(app);

API con spazio dei nomi Web

import firebase from "firebase/compat/app";
import "firebase/compat/analytics";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Analytics and get a reference to the service
const analytics = firebase.analytics();

Utilizza Firebase con il tagging gtag.js esistente

Se in precedenza avevi Google Analytics in esecuzione nella tua app utilizzando lo snippet gtag.js , l'app potrebbe richiedere una configurazione aggiuntiva se prevedi di eseguire una delle seguenti operazioni:

  • Aggiungi le chiamate di Google Analytics da Firebase alla pagina, ma pianifica anche di continuare a utilizzare le chiamate gtag() direttamente sulla stessa pagina.
  • Desideri utilizzare lo stesso ID misurazione sia tra le chiamate dirette gtag() che tra i dati di Google Analytics inviati a Firebase.

Per garantire che i tuoi eventi siano disponibili per l'utilizzo da parte di tutti i servizi Firebase, completa i seguenti passaggi di configurazione aggiuntivi:

  • Rimuovi la riga gtag('config', ' GA_MEASUREMENT_ID '); dove GA_MEASUREMENT_ID è l' measurementId della tua app web Firebase. Se nella pagina sono presenti altri ID per altre proprietà Analytics, non è necessario rimuovere la relativa riga di configurazione.
  • Assicurati di chiamare firebase.analytics() prima di inviare qualsiasi evento con gtag() .

In caso contrario, gli eventi inviati a tale ID con chiamate gtag() non verranno associati a Firebase e non saranno disponibili per il targeting in altri servizi Firebase.

Inizia a registrare gli eventi

Dopo aver inizializzato il servizio Analytics , puoi iniziare a registrare gli eventi con il metodo logEvent() .

Alcuni eventi sono consigliati per tutte le app ; altri sono consigliati per tipi di attività o settori verticali specifici. Dovresti inviare gli eventi suggeriti insieme ai parametri prescritti, per garantire il massimo dettaglio disponibile nei tuoi report e per trarre vantaggio dalle funzionalità e integrazioni future non appena diventano disponibili. Questa sezione illustra la registrazione di un evento predefinito. Per ulteriori informazioni sulla registrazione degli eventi, vedere Registrare eventi .

L'esempio seguente mostra come registrare un evento consigliato per indicare che un utente ha ricevuto una notifica nella tua app:

Web modular API

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

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

Web namespaced API

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

Prossimi passi