Registra eventi

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

Gli eventi forniscono informazioni su ciò che accade nella tua app, ad esempio azioni degli utenti, eventi di sistema o errori.

Analytics registra automaticamente alcuni eventi per te; non devi aggiungere codice per riceverli. Se la tua app deve raccogliere dati aggiuntivi, puoi registrare fino a 500 diversi Analytics eventi tipi 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 degli eventi 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.

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 è equivalente 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.

Puoi trovare i dettagli di implementazione per diversi eventi e i relativi parametri in the documentazione di riferimento degli eventi di 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 Analytics report. Puoi utilizzare le dimensioni personalizzate per i dati dei parametri evento non numerici e le metriche personalizzate per i dati dei parametri rappresentati meglio numericamente. 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 BigQuery Export di Google Analytics 4.

  • Parametro value: value è un parametro di uso generale 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 obiettivo specifico, puoi registrare un evento simile a quello dell'esempio seguente:

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 le statistiche aggregate sugli eventi nelle Firebase console dashboards. Queste dashboard vengono aggiornate periodicamente durante la giornata. Per i test immediati, utilizza l'output logcat come descritto nella sezione precedente.

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