Catch up on highlights from Firebase at Google I/O 2023. Learn more

Registra eventi

Questa guida mostra come registrare gli eventi nella tua app.

Gli eventi forniscono informazioni su ciò che sta accadendo nella tua app, ad esempio azioni dell'utente, eventi di sistema o errori.

Analytics registra automaticamente alcuni eventi per te; non è necessario aggiungere alcun codice per riceverli. Se la tua app deve raccogliere dati aggiuntivi, puoi registrare fino a 500 diversi tipi di eventi di Analytics nella tua app. Non c'è limite al volume totale di eventi registrati dall'app. Tieni presente che i nomi degli eventi fanno distinzione tra maiuscole e minuscole e che la registrazione di due eventi i cui nomi differiscono solo per maiuscole e minuscole risulterà in due eventi distinti.

Prima di iniziare

Assicurati di aver impostato il tuo progetto e di poter accedere ad Analytics come descritto in Introduzione ad Analytics .

Registra eventi

Dopo aver configurato l'istanza firebase.analytics() , puoi iniziare a registrare gli eventi con il metodo logEvent() . Se hai già familiarità con Google Analytics, questo metodo equivale all'utilizzo del comando event in gtag.js .

Per aiutarti a iniziare, l'SDK di Analytics definisce una serie di eventi consigliati comuni a diversi tipi di app, tra cui app di vendita al dettaglio ed e-commerce, viaggi e giochi. Per ulteriori informazioni su questi eventi e su quando utilizzarli, consulta Eventi consigliati .

Nota: per ottenere il massimo dettaglio nei report, registra gli eventi consigliati che hanno senso per la tua app e i relativi parametri prescritti. Ciò garantisce inoltre di beneficiare delle ultime funzionalità di Google Analytics non appena diventano disponibili.

Puoi trovare i dettagli di implementazione per diversi eventi e i relativi parametri nel riferimento all'evento gtag.js .

L'esempio seguente mostra come registrare un evento select_content :

Web modular API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});

Web namespaced API

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Oltre ai parametri prescritti, è possibile aggiungere i seguenti parametri a qualsiasi evento:

  • Parametri personalizzati: i parametri personalizzati possono essere utilizzati come dimensioni o metriche nei rapporti Analytics . Puoi utilizzare le dimensioni personalizzate per i dati dei parametri degli eventi non numerici e le metriche personalizzate per i dati dei parametri meglio rappresentati numericamente. Dopo aver registrato un parametro personalizzato utilizzando l'SDK, registra la dimensione o la metrica per assicurarti che tali parametri personalizzati vengano visualizzati nei rapporti di Analytics. Procedi tramite: Analisi > Eventi > Gestisci definizioni personalizzate > Crea dimensioni personalizzate

    I parametri personalizzati possono essere utilizzati nelle definizioni del pubblico che possono essere applicate a ogni rapporto. I parametri personalizzati sono inclusi anche nei dati esportati in BigQuery se la tua app è collegata a un progetto BigQuery. Trova query di esempio e molto altro in Google Analytics 4 BigQuery Export .

  • parametro value : value è un parametro generico utile per accumulare una metrica chiave relativa a un evento. Gli esempi includono entrate, distanza, tempo e punti.

Se la tua applicazione ha esigenze specifiche non coperte da un tipo di evento consigliato, puoi registrare i tuoi eventi personalizzati. Ad esempio, se stai sviluppando un gioco e desideri monitorare quando un giocatore completa un determinato obiettivo, puoi registrare un evento simile al seguente esempio:

Web modular API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

Web namespaced API

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

Visualizza gli eventi nella dashboard

Puoi visualizzare statistiche aggregate sui tuoi eventi nelle dashboard della console Firebase. Questi dashboard si aggiornano periodicamente durante il giorno. Per test immediati, utilizzare l'output di logcat come descritto nella sezione precedente.

Puoi accedere a questi dati dalla dashboard Eventi nella console Firebase. Questa dashboard mostra i rapporti sugli eventi che vengono creati automaticamente per ogni tipo distinto di evento registrato dalla tua app.