Registra eventi

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


Gli eventi forniscono informazioni su cosa sta succedendo nella tua app, come azioni degli utenti, 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 tipi di eventi Analytics diversi nella tua app (2000 se utilizzi Google Analytics 360). Non esiste un limite al volume totale di eventi registrati dalla tua app. Tieni presente che i nomi evento sono sensibili alle maiuscole e che la registrazione di due eventi i cui nomi differiscono solo per l'uso delle maiuscole genera due eventi distinti.

Prima di iniziare

Assicurati di aver configurato il progetto e di poter accedere ad Analytics come descritto in Inizia a utilizzare 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 Analytics definisce una serie di eventi consigliati comuni a diversi tipi di app, tra cui app di vendita al dettaglio ed e-commerce, di viaggi e app di gioco. Per scoprire di più su questi eventi e su quando utilizzarli, consulta Eventi consigliati.

Puoi trovare i dettagli di implementazione di diversi eventi e dei relativi parametri nella documentazione di riferimento sugli eventi gtag.js.

L'esempio seguente mostra come registrare un evento select_content:

Web

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

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

Web

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

Oltre ai parametri obbligatori, puoi aggiungere i seguenti parametri a qualsiasi evento:

  • Parametri personalizzati: i parametri personalizzati possono essere utilizzati come dimensioni o metriche nei report Analytics. Puoi utilizzare le dimensioni personalizzate per i dati dei parametri evento non numerici e le metriche personalizzate per i dati dei parametri che è meglio rappresentare numericamente. Dopo aver registrato un parametro personalizzato utilizzando l'SDK, registra la dimensione o la metrica per assicurarti che i parametri personalizzati vengano visualizzati nei report di Analytics. Per farlo, nella console Firebase, vai ad Analytics > Definizioni personalizzate.

    I parametri personalizzati possono essere utilizzati nelle definizioni dei segmenti di pubblico che possono essere applicate a ogni report. 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 BigQuery Export di Google Analytics 4.

  • Parametro value: value è un parametro generico utile per accumulare una metrica chiave relativa a un evento. Alcuni esempi sono le entrate, la distanza, il tempo e i 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 vuoi monitorare quando un giocatore completa un obiettivo specifico, puoi registrare un evento simile al seguente esempio:

Web

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

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

Web

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

Visualizza gli eventi nella dashboard

Nella console Firebase, puoi visualizzare le statistiche aggregate relative agli eventi nella dashboard Eventi di Analytics.

Tieni presente quanto segue in merito a questa dashboard:

  • La dashboard mostra i report sugli eventi creati automaticamente per ogni tipo distinto di evento registrato dalla tua app.

  • La dashboard viene aggiornata periodicamente durante il giorno. Per un test immediato, utilizza DebugView.