Iniziare a utilizzare Google Analytics


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

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

  • Eventi: cosa succede nella tua app, ad esempio azioni degli utenti, eventi di sistema o errori.

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

Analytics registra automaticamente alcuni eventi e proprietà utente. Non devi 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 stai creando un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.

  • Se utilizzi un progetto Firebase esistente in cui Google Analytics non è attivo, vai alla scheda Integrazioni di > Impostazioni progetto per attivarlo.

Quando attivi Google Analytics nel progetto, le app web Firebase vengono collegate agli stream di dati Google Analytics associati a una proprietà App + web.

Aggiungi l'SDK Analytics alla tua app

A seconda di come è ospitata l'applicazione web, la configurazione potrebbe essere gestita automaticamente o potrebbe essere necessario aggiornare l'oggetto di configurazione Firebase. Se la tua app web utilizza già Google Analytics, potresti dover eseguire un'ulteriore configurazione descritta in Utilizzare Firebase con il tagging gtag.js esistente.

  1. 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 è obbligatorio 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 progetto al tag <body> della tua app, se non l'hai ancora fatto.

    • Se la tua app non utilizza URL riservati: Se stai utilizzando un'app web esistente, aggiorna l'oggetto di configurazione Firebase nel codice per assicurarti che il campo measurementId sia presente. L'oggetto config dovrebbe avere un aspetto simile all'esempio seguente:

      // 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 l'hai ancora fatto, installa l'SDK Firebase JS e inizializza Firebase.

  3. Aggiungi l'SDK JS Analytics 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 utilizzavi Google Analytics 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 di continuare a utilizzare le chiamate gtag() direttamente sulla stessa pagina.
  • Vuoi utilizzare lo stesso ID misurazione sia per le chiamate gtag() dirette 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'); 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 riga di configurazione.
  • Assicurati di chiamare firebase.analytics() prima di inviare eventi con gtag().

In caso contrario, gli eventi inviati a quell'ID con le 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 eventi suggeriti insieme ai relativi parametri obbligatori per garantire il livello massimo di dettagli disponibili nei report e sfruttare le funzionalità e le integrazioni future non appena diventeranno disponibili. Questa sezione mostra come eseguire il logging di un evento predefinito. Per ulteriori informazioni sul logging degli eventi, consulta Eventi di log.

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');
analytics_log_event.js

Web

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

Passaggi successivi