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 utilizzi un progetto Firebase esistente su cui non è abilitato Google Analytics, vai alla scheda Integrazioni del tuo
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
- Comprendere ogni rapporto di Analytics .
- 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.