Questa guida introduttiva mostra come aggiungere Google Analytics alla tua app e iniziare a registrare gli eventi.
Google Analytics raccoglie dati sull'utilizzo e sul comportamento per la tua app web. L'SDK registra due tipi principali di informazioni:
Eventi : ciò che sta accadendo nella tua app, ad esempio azioni dell'utente, eventi di sistema o errori.
Proprietà utente : attributi che definisci per descrivere i segmenti della tua base di 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 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 stai utilizzando un progetto Firebase esistente che non ha Google Analytics abilitato, vai alla scheda Integrazioni delle tue > 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 di come è ospitata la tua applicazione web, la tua configurazione potrebbe essere gestita automaticamente o potrebbe essere necessario aggiornare il tuo oggetto di configurazione Firebase . Se la tua app web utilizza già Google Analytics, potrebbe essere necessario eseguire la configurazione aggiuntiva descritta in Utilizzare Firebase con la codifica gtag.js esistente .
Verifica che il tuo oggetto di configurazione Firebase nel tuo 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 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 tuo codice per assicurarti che il campo
measurementId
sia presente. L'oggetto config 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" };
Se non lo hai già fatto, installa Firebase JS SDK e inizializza Firebase .
Aggiungi Analytics SDK 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 la codifica 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 le chiamate di Google Analytics da Firebase alla pagina, ma pianifica anche di continuare a utilizzare le chiamate
gtag()
direttamente sulla stessa pagina. - Vuoi utilizzare lo stesso ID misurazione tra le chiamate dirette
gtag()
e i dati di 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 è necessario rimuovere la loro riga di configurazione. - Assicurati di chiamare
firebase.analytics()
prima di inviare qualsiasi evento congtag()
.
In caso contrario, gli eventi inviati a quell'ID con chiamate gtag()
non saranno 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 specifici tipi di attività o verticali. Dovresti inviare gli eventi suggeriti insieme ai loro parametri prescritti, per garantire il massimo dettaglio disponibile nei tuoi report e per beneficiare delle future funzionalità e integrazioni non appena saranno disponibili. Questa sezione illustra la registrazione di un evento predefinito, per ulteriori informazioni sulla registrazione degli eventi, vedere Log events .
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
- Usa DebugView per verificare i tuoi eventi.
- Esplora i tuoi dati nella console Firebase .
- Esplora le guide su eventi e proprietà utente.
- Scopri come esportare i tuoi dati in BigQuery.