Registra eventi

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

Eventi forniscono informazioni su quanto sta accadendo nella vostra applicazione, come ad esempio le azioni degli utenti, gli eventi di sistema o errori.

Analytics registra automaticamente alcuni eventi per voi; non è necessario aggiungere alcun codice per riceverli. Se la vostra applicazione ha bisogno di raccogliere ulteriori dati, è possibile accedere fino a 500 diversi tipi Analytics evento nella vostra app. Non c'è limite al volume totale di eventi che la tua app registra. Si noti che i nomi degli eventi fanno distinzione tra maiuscole e minuscole e che la registrazione di due eventi i cui nomi differiscono solo nel caso si tradurrà in due eventi distinti.

Prima di iniziare

Assicurarsi di aver impostato il progetto e può accedere Analytics come descritto in Introduzione a Analytics .

Registra eventi

Dopo aver configurato il FirebaseApp esempio, è possibile iniziare a registrare gli eventi con la logEvent() metodo.

Per aiutarti a iniziare, l'SDK di Analytics definisce una serie di eventi suggeriti comuni tra i diversi tipi di app, tra cui app di vendita al dettaglio ed e-commerce, viaggi e giochi. Per ulteriori informazioni su questi eventi e quando utilizzarli, visualizza le Eventi e proprietà articoli nel Centro assistenza Firebase.

È possibile trovare i dettagli di implementazione di riferimento costanti per Swift e Objective-C .

L'esempio seguente mostra come accedere un suggerito kFIRSelectContent evento:

Veloce

Nota: Questo prodotto Firebase non è disponibile sul bersaglio MacOS.
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 in ogni caso i seguenti parametri:

  • I parametri personalizzati: parametri personalizzati possono essere utilizzati come dimensioni o metriche di rapporti di Analytics . È possibile utilizzare dimensioni personalizzate per i dati dei parametri degli eventi non numerici e le metriche personalizzate per tutti i dati dei parametri meglio rappresentati numericamente. Dopo aver registrato un parametro personalizzato utilizzando l'SDK, registra la dimensione o la metrica per assicurarti che tali parametri personalizzati vengano visualizzati nei rapporti di Analytics. Fate questo tramite: Analytics> Eventi> Gestisci definizioni personalizzate> Creare dimensioni personalizzate

    I parametri personalizzati possono essere utilizzati in pubblico le definizioni che possono essere applicati ad ogni rapporto. I parametri personalizzati sono inclusi anche nei dati esportati in BigQuery se la vostra applicazione è legata a un progetto BigQuery. Trova query di esempio e altro ancora su Google Analytics 4 BigQuery Export .

  • kFIRParameterValue parametro: kFIRParameterValue è un parametro generale scopo che è utile per accumulare una metrica chiave che riguarda un evento. Gli esempi includono entrate, distanza, tempo e punti.

Se la tua applicazione ha esigenze specifiche non coperte da un tipo di evento suggerito, puoi registrare i tuoi eventi personalizzati come mostrato in questo esempio:

Veloce

Nota: Questo prodotto Firebase non è disponibile sul bersaglio MacOS.
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 dell'evento predefiniti

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

Come per i parametri personalizzati, registra i parametri dell'evento predefiniti per assicurarti che tali parametri personalizzati vengano visualizzati nei rapporti di Analytics.

Veloce

Nota: Questo prodotto Firebase non è disponibile sul bersaglio MacOS.
Analytics.setDefaultEventParameters([ "level_name": "Caverns01", "level_difficulty": 4 ])

Obiettivo-C

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

Se un parametro viene specificed nel logEvent() metodo, tale valore viene utilizzato al posto del default.

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

Visualizza gli eventi nella console di debug di 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 eventi registrati sia automaticamente che manualmente.

È possibile abilitare la registrazione dettagliata come segue:

  1. In Xcode, selezionare prodotto> Piano> Modifica schema ...
  2. Selezionare Esegui dal menu a sinistra.
  3. Selezionare la scheda Argomenti.
  4. Negli argomenti trasmessi sezione di avvio, add -FIRAnalyticsDebugEnabled .

La prossima volta che eseguirai 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 nelle dashboard della console Firebase. Questi dashboard si aggiornano periodicamente nel corso della giornata. Per il test immediato, utilizzare l'output logcat come descritto nella sezione precedente.

È possibile accedere a questi dati da eventi cruscotto nella console Firebase. Questa dashboard mostra i rapporti sugli eventi che vengono creati automaticamente per ogni tipo distinto di evento registrato dalla tua app.