Iniziare a utilizzare Google Analytics per il web

Seleziona la piattaforma: iOS+ Android Web Flutter Unity C++

Questa guida rapida 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 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. Per abilitarli non è necessario aggiungere alcun codice.

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 generi 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 > Impostazioni progetto per attivarlo.

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 di 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.

  1. Verifica che l'oggetto di configurazione di 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 dell'applicazione. Per completare la configurazione, aggiungi gli script dalla scheda Le tue app in 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 di Firebase nel codice per assicurarti che il campo measurementId sia presente. L'oggetto di configurazione 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: "PROJECT_ID.firebasestorage.app",
  messagingSenderId: "SENDER_ID",
  appId: "APP_ID",
  measurementId: "G-GA_MEASUREMENT_ID"
};
      { Se non l'hai già fatto, installa l'SDK Firebase JS e inizializza Firebase. 2. 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 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:

  • Aggiungere chiamate Google Analytics da Firebase alla pagina, ma anche pianificare di continuare a utilizzare le chiamate gtag() direttamente sulla stessa pagina.
  • Utilizzare lo stesso ID misurazione sia per le chiamate gtag() dirette sia per i dati inviati a Firebase.Google Analytics

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 è measurementId della tua app web Firebase. Se nella pagina hai altri ID per altre proprietà Analytics, non devi rimuovere la riga di configurazione.
  • Assicurati di chiamare firebase.analytics() prima di inviare eventi con gtag().

In caso contrario, gli eventi inviati a questo ID con le chiamate gtag() non saranno associati a Firebase e non saranno disponibili per il targeting in altri servizi Firebase.

Avviare la registrazione degli eventi

Dopo aver inizializzato il servizio Analytics, puoi iniziare a registrare gli eventi con il logEvent() metodo.

Alcuni eventi sono consigliati per tutte le app; altri sono consigliati per tipi o verticali di attività specifici. Ti suggeriamo di inviare gli eventi suggeriti con i relativi parametri prescritti, per garantire il livello massimo di dettagli disponibile nei report e per usufruire delle funzionalità e delle integrazioni future non appena diventano disponibili. Questa sezione mostra come registrare un evento predefinito. Per ulteriori informazioni 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');
analytics_log_event.js

Web

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

Passaggi successivi