Questa guida rapida mostra come aggiungere Google Analytics alla tua app e iniziare a registrare gli eventi.
Google Analytics raccoglie dati di utilizzo e comportamento per la tua app web. L'SDK registra due tipi principali di informazioni:
Eventi: cosa sta succedendo nella tua app, ad esempio azioni degli utenti, eventi di sistema o errori.
Proprietà utente: attributi che definisci per descrivere i segmenti della tua base utenti, come la preferenza della lingua o la posizione geografica.
Analytics registra automaticamente alcuni eventi e proprietà utente; non è necessario aggiungere alcun codice per abilitarli.
Prima di iniziare
Se non lo hai già fatto, aggiungi Firebase al tuo progetto JavaScript e assicurati che Google Analytics sia abilitato nel progetto Firebase:
Se crei un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.
Se utilizzi un progetto Firebase esistente in cui non è abilitato Google Analytics, vai alla scheda Integrazioni di
per attivarlo. > Impostazioni progetto
Quando attivi Google Analytics nel tuo progetto, le app web Firebase vengono collegate agli stream di dati di Google Analytics associati a una proprietà App + Web.
Aggiungere l'SDK Analytics all'app
A seconda di come viene ospitata l'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, potresti dover eseguire una configurazione aggiuntiva descritta in Utilizzare Firebase con il tagging gtag.js esistente.
Controlla che l'oggetto di configurazione Firebase nel codice contenga
measurementId
. Questo ID viene creato automaticamente quando attivi 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 dell'applicazione. Per completare la configurazione, aggiungi gli script dalla scheda Le tue app nelle Impostazioni progetto al tag <body> della tua app, se non l'hai già fatto.
Se la tua app non utilizza URL riservati: Se stai lavorando con un'app web esistente, aggiorna l'oggetto di configurazione Firebase nel codice per assicurarti che il campo
measurementId
sia presente. L'oggetto config dovrebbe essere simile all'esempio seguente:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "API_KEY", authDomain: "PROJECT_ID.firebaseapp.com", databaseURL: "https://PROJECT_ID.firebaseio.com", projectId: "PROJECT_ID", storageBucket: "
", messagingSenderId: "SENDER_ID", appId: "APP_ID", measurementId: "G-GA_MEASUREMENT_ID" };PROJECT_ID.firebasestorage.app
Se non l'hai ancora fatto, installa l'SDK Firebase JS e inizializza Firebase.
Aggiungi l'SDK Analytics JS e inizializza Analytics:
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);
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();
Utilizzare Firebase con il tagging gtag.js esistente
Se in precedenza avevi Google Analytics in esecuzione nella tua app utilizzando lo snippet gtag.js, la tua app potrebbe richiedere una configurazione aggiuntiva se prevedi di eseguire una delle seguenti operazioni:
- Aggiungi chiamate Google Analytics da Firebase alla pagina, ma prevedi anche di continuare a utilizzare le chiamate
gtag()
direttamente sulla stessa pagina. - Vuoi utilizzare lo stesso ID misurazione sia per le chiamate dirette
gtag()
sia per i dati Google Analytics inviati a Firebase.
Per assicurarti 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');
doveGA_MEASUREMENT_ID
è l'measurementId
della tua app web Firebase. Se nella pagina sono presenti altri ID per altre proprietà Analytics, non devi rimuovere la riga di configurazione. - Assicurati di chiamare
firebase.analytics()
prima di inviare eventi congtag()
.
In caso contrario, gli eventi inviati a questo ID con chiamate gtag()
non verranno associati
a Firebase e non saranno disponibili per il targeting in altri
servizi Firebase.
Avvia la registrazione degli 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 verticali o tipi di attività specifici. Ti consigliamo di inviare gli eventi suggeriti insieme ai relativi parametri obbligatori per garantire il massimo livello di dettagli disponibile nei report e usufruire delle funzionalità e delle integrazioni future non appena diventano disponibili. Questa sezione mostra la registrazione di un evento predefinito. Per saperne di più sulla registrazione degli eventi, vedi Registrare gli eventi.
L'esempio seguente mostra come registrare un evento consigliato per indicare che un utente ha ricevuto una notifica nella tua app:
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web
firebase.analytics().logEvent('notification_received');
Passaggi successivi
- Comprendere ogni report di Analytics.
- Utilizza DebugView per verificare gli eventi.
- Esplora i tuoi dati nella console Firebase.
- Esplora le guide su eventi e proprietà utente.
- Scopri come esportare i dati in BigQuery.