Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Registra eventi

Questa guida mostra come registrare gli eventi nella tua app.

Gli eventi forniscono informazioni su ciò che sta accadendo nella tua app, come 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 di Analytics nella tua 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 in cui si verifichino due eventi distinti.

Prima di iniziare

Assicurati di aver impostato il tuo progetto e di poter accedere ad Analytics come descritto in Guida introduttiva 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 suggeriti comuni a diversi tipi di app, comprese le app di vendita al dettaglio e di e-commerce, viaggi e giochi. Per ulteriori informazioni su questi eventi e su quando utilizzarli, consulta gli articoli [Events and properties] [recommended-events-hc] nel Centro assistenza di Firebase.

Puoi trovare dettagli sull'implementazione nel riferimento alle costanti per Swift e Objective-C .

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

veloce

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

Objective-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 registrati per i rapporti nei rapporti Analytics. Possono anche essere utilizzati come filtri nelle definizioni dei destinatari che possono essere applicati a ogni rapporto. I parametri personalizzati sono inclusi anche nei dati esportati in BigQuery se la tua app è collegata a un progetto BigQuery.

  • Parametro kFIRParameterValue : kFIRParameterValue è un parametro generico 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 suggerito, 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
  ])

Objective-C

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

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, seleziona Prodotto> Schema> Modifica schema ...
  2. Seleziona Esegui dal menu a sinistra.
  3. Seleziona la scheda Argomenti .
  4. Nella sezione Argomenti passati -FIRAnalyticsDebugEnabled , aggiungi -FIRAnalyticsDebugEnabled .

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 siano stati inviati.

Visualizza gli eventi nella dashboard

Puoi visualizzare statistiche aggregate sui tuoi eventi nelle dashboard della console Firebase. Questi dashboard vengono aggiornati periodicamente durante il giorno. Per un test immediato, utilizzare l'output di logcat come descritto nella sezione precedente.

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