Registra eventi

Questa guida ti mostra come registrare gli eventi nella tua app.

Gli eventi forniscono informazioni dettagliate su ciò che sta accadendo nella tua app, ad esempio azioni dell'utente, 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 diversi tipi di eventi Analytics nella tua app. Non esiste alcun limite al volume totale di eventi registrati dall'app. Tieni presente che i nomi degli eventi fanno distinzione tra maiuscole e minuscole e che la registrazione di due eventi i cui nomi differiscono solo per la distinzione tra maiuscole e minuscole genera due eventi distinti.

Prima di iniziare

Assicurati di aver impostato il tuo progetto e di poter accedere ad Analytics come descritto in Introduzione ad Analytics .

Registra eventi

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

Per aiutarti a iniziare, l'SDK di Analytics definisce una serie di eventi consigliati comuni tra diversi tipi di app, tra cui app di vendita al dettaglio ed e-commerce, di viaggi e di gioco. Per ulteriori informazioni su questi eventi e su quando utilizzarli, consulta Eventi consigliati .

Puoi trovare i dettagli di implementazione nel riferimento alle costanti per Swift e Objective-C .

L'esempio seguente dimostra come registrare un evento kFIRSelectContent consigliato:

Veloce

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Obiettivo-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

Oltre ai parametri prescritti, è possibile aggiungere a qualsiasi evento i seguenti parametri:

  • Parametri personalizzati: i parametri personalizzati possono essere utilizzati come dimensioni o metriche nei rapporti Analytics . Puoi utilizzare dimensioni personalizzate per dati di parametri evento non numerici e metriche personalizzate per qualsiasi dato di parametro meglio rappresentato numericamente. Dopo aver registrato un parametro personalizzato utilizzando l'SDK, registra la dimensione o la metrica per garantire che tali parametri personalizzati vengano visualizzati nei rapporti Analytics. Puoi farlo tramite: Analytics > Eventi > Gestisci definizioni personalizzate > Crea dimensioni personalizzate

    I parametri personalizzati possono essere utilizzati nelle definizioni del 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 ancora in Google Analytics 4 BigQuery Export .

  • Parametro kFIRParameterValue : kFIRParameterValue è un parametro di uso generale utile per accumulare una metrica chiave relativa a un evento. Gli 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:

Veloce

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

Obiettivo-C

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

Imposta i parametri evento predefiniti

È possibile registrare i parametri tra gli eventi utilizzando setDefaultEventParameters . I parametri predefiniti sono associati a tutti gli eventi futuri registrati.

Come con i parametri personalizzati, registra i parametri evento predefiniti per garantire che tali parametri personalizzati vengano visualizzati nei rapporti Analytics.

Veloce

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

Obiettivo-C

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

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

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

Visualizza gli eventi nella console di debug Xcode

È possibile abilitare la registrazione dettagliata per monitorare la registrazione degli eventi da parte dell'SDK per verificare che gli eventi vengano registrati correttamente. Ciò include sia gli eventi registrati automaticamente che quelli registrati manualmente.

È possibile abilitare la registrazione dettagliata come segue:

  1. In Xcode, seleziona Prodotto > Schema > Modifica schema...
  2. Seleziona Esegui dal menu a sinistra.
  3. Seleziona la scheda Argomenti .
  4. Nella sezione Argomenti passati all'avvio aggiungere -FIRAnalyticsVerboseLoggingEnabled .

La prossima volta che esegui la tua app, i tuoi eventi verranno visualizzati nella console di debug di Xcode, aiutandoti a verificare immediatamente che gli eventi vengano inviati.

Visualizza gli eventi nella dashboard

Puoi visualizzare statistiche aggregate sui tuoi eventi nei dashboard della console Firebase. Queste dashboard si aggiornano periodicamente durante il giorno. Per un test immediato, utilizzare l'output logcat come descritto nella sezione precedente.

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