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. 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 stai utilizzando un progetto Firebase esistente su cui non è abilitato Google Analytics, 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 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 .
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" };
Se non lo hai già fatto, installa Firebase JS SDK e inizializza Firebase .
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 ');
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 relativa riga di configurazione. - Assicurati di chiamare
firebase.analytics()
prima di inviare qualsiasi evento congtag()
.
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
- Utilizza 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.