Registra eventi

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 Analytics tipi di eventi 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 a Analytics come descritto in Guida introduttiva a Analytics.

Se vuoi raccogliere i dati di attribuzione delle campagne, assicurati di aggiungere il framework AdSupport al tuo progetto.

Eventi dei log

Dopo aver configurato l'istanza FirebaseApp, puoi iniziare a registrare gli eventi con il metodo logEvent().

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 dell'implementazione nel riferimento alle costanti per Swift e Objective-C.

Il seguente esempio mostra come registrare un evento kFIRSelectContent consigliato:

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
ObjCMigratedSnippets.m

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, 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 Google Analytics 4 BigQuery Export.

• Parametro kFIRParameterValue: kFIRParameterValue è un parametro generico utile per accumulare una metrica chiave relativa a un evento. Alcuni 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 come mostrato in questo esempio:

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
ObjCMigratedSnippets.m

Impostare i parametri evento predefiniti

Puoi registrare i parametri tra gli 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 questi parametri personalizzati vengano visualizzati nei report di Analytics.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

Se un parametro viene specificato nel metodo logEvent(), viene utilizzato questo valore anziché quello predefinito.

Per cancellare un parametro predefinito, chiama il metodo setDefaultEventParameters con il parametro impostato su nil.

Visualizzare gli eventi nella console di debug Xcode

Puoi attivare il logging dettagliato per monitorare il logging degli eventi da parte dell'SDK e verificare che gli eventi vengano registrati correttamente. Sono inclusi sia gli eventi registrati automaticamente sia quelli registrati manualmente.

Puoi attivare il logging dettagliato nel seguente modo:

1. In Xcode, seleziona Product > Scheme > Edit scheme… (Prodotto > Schema > Modifica schema…).
2. Seleziona Run (Esegui) dal menu a sinistra.
3. Seleziona la scheda Arguments (Argomenti).
4. Nella sezione Arguments Passed On Launch (Argomenti passati al momento dell'avvio), aggiungi -FIRAnalyticsVerboseLoggingEnabled.

La prossima volta che esegui l'app, gli eventi verranno visualizzati nella console di debug di Xcode, consentendoti di verificare immediatamente che vengano inviati.

Visualizzare gli eventi nella dashboard

Nella console Firebase, puoi visualizzare le statistiche aggregate sugli eventi nella dashboard Analytics > Eventi.

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 i test immediati, utilizza l'output della console di debug di Xcode come descritto nella sezione precedente di questa guida.