Questa guida spiega come registrare gli eventi nella tua app.
Analytics registra automaticamente alcuni eventi per te; non è necessario aggiungere codice per riceverli. Se la tua app deve raccogliere dati aggiuntivi, puoi registrare fino a 500 diversi tipi di eventi Analytics. Non esiste alcun limite per il 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 avrà come risultato due eventi distinti.
Prima di iniziare
Assicurati di aver configurato il progetto e di poter accedere ad Analytics come descritto nella Guida introduttiva ad Analytics.
Eventi dei log
Dopo aver creato un'istanza FirebaseAnalytics, puoi utilizzarla per registrare gli eventi con i metodi log della libreria.
Eventi predefiniti
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 di giochi. Per scoprire di più su questi eventi e su quando utilizzarli, consulta Eventi consigliati.
Puoi trovare i metodi di log per i tipi di eventi consigliati nel riferimento all'API.
L'esempio seguente mostra come registrare un evento select_content:
await FirebaseAnalytics.instance.logSelectContent(
contentType: "image",
itemId: itemId,
);
In alternativa, puoi registrare lo stesso evento utilizzando logEvent():
await FirebaseAnalytics.instance.logEvent(
name: "select_content",
parameters: {
"content_type": "image",
"item_id": itemId,
},
);
Questa opzione può essere utile se vuoi specificare parametri aggiuntivi diversi da quelli previsti (obbligatori). Puoi aggiungere i seguenti parametri a qualsiasi evento:
Parametri personalizzati: i parametri personalizzati possono essere utilizzati come dimensioni o metriche nei report di Analytics. Puoi utilizzare le dimensioni personalizzate per i dati dei parametri evento non numerici e le metriche personalizzate per qualsiasi dato del parametro rappresentato meglio in modo 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 applicati 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 per Google Analytics 4.
Parametro
value: un parametro generico utile per accumulare una metrica chiave relativa a un evento. Alcuni esempi sono entrate, distanza, tempo e punti.I nomi dei parametri possono avere una lunghezza massima di 40 caratteri, devono iniziare con un carattere alfabetico e contenere solo caratteri alfanumerici e trattini bassi. I tipi di stringa e numero sono supportati. I valori dei parametri di stringa possono contenere fino a 100 caratteri. I prefissi "firebase", "google" e "ga_" sono riservati e non devono essere utilizzati per i nomi dei parametri.
Eventi personalizzati
Se la tua applicazione ha esigenze specifiche non coperte da un tipo di evento consigliato, puoi registrare i tuoi eventi personalizzati come mostrato in questo esempio:
await FirebaseAnalytics.instance.logEvent(
name: "share_image",
parameters: {
"image_name": name,
"full_text": text,
},
);
Impostare i parametri evento predefiniti
Puoi registrare i parametri in più eventi utilizzando setDefaultEventParameters().
I parametri predefiniti sono associati a tutti gli eventi futuri registrati.
Come per i parametri personalizzati, registra i parametri evento predefiniti per assicurarti che appaiano nei report di Analytics.
I valori dei parametri validi sono String e num. Se imposti il valore di una chiave su null
viene cancellato il parametro. Se passi un valore nullo, vengono cancellati tutti i parametri.
// Not supported on web
await FirebaseAnalytics.instance
.setDefaultEventParameters({
version: '1.2.3'
});
Se nel metodo logEvent() o log viene specificato un parametro, viene utilizzato questo valore anziché quello predefinito.
Per cancellare un parametro predefinito, chiama il metodo setDefaultEventParameters()
con il parametro impostato su null.
Visualizzare gli eventi nella dashboard
Puoi visualizzare le statistiche aggregate relative ai tuoi 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.