Registra eventi


Questa guida mostra come registrare gli eventi nella tua app.

Gli eventi forniscono informazioni su cosa sta succedendo nella tua app, ad esempio azioni degli utenti, eventi di sistema o errori.

Analytics registra automaticamente alcuni eventi per te; non devi aggiungere alcun codice per riceverli. Se la tua app deve raccogliere dati aggiuntivi, puoi registrare fino a 500 diversi tipi di eventi Analytics nella tua app. Non esiste un limite al volume totale di eventi registrati dalla tua app. Tieni presente che i nomi degli eventi sono sensibili alle maiuscole e che la registrazione di due eventi i cui nomi differiscono solo per l'uso delle maiuscole risulta in 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.

Eventi dei log

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, viaggi e giochi. Per scoprire di più su questi eventi e su quando utilizzarli, consulta Eventi consigliati.

Nota:per ottenere il massimo livello di dettaglio nei report, registra gli eventi consigliati che hanno senso per la tua app e i relativi parametri prescritti. In questo modo, potrai usufruire delle funzionalità più recenti di Google Analytics non appena diventano disponibili.

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

Il seguente esempio 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'
});
analytics_log_event_params.js

Web

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

Oltre ai parametri prescritti, 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 rappresentati meglio in formato numerico. Dopo aver registrato un parametro personalizzato utilizzando l'SDK, registra la dimensione o la metrica per assicurarti che questi parametri personalizzati vengano visualizzati nei report di Analytics. Per farlo, vai a: Analytics > Eventi > Gestisci definizioni personalizzate > Crea dimensioni 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 Esportazione in BigQuery di Google Analytics 4.

  • Parametro value: value è un parametro generico utile per accumulare una metrica chiave relativa a un evento. Alcuni esempi sono 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 vuoi monitorare quando un giocatore completa un determinato obiettivo, 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'});
analytics_log_event_custom_params.js

Web

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

Visualizzare gli eventi nella dashboard

Puoi visualizzare statistiche aggregate sugli eventi nelle dashboard della console Firebase. Queste dashboard vengono aggiornate periodicamente nel corso della giornata. Per i test immediati, utilizza l'output di logcat come descritto nella sezione precedente.

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