Registra eventi

Seleziona la piattaforma: iOS+ Android Web Flutter Unity C++

Analytics registra automaticamente alcuni eventi per te, quindi non devi 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 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 avrà come risultato due eventi distinti.

Prima di iniziare

Assicurati di aver configurato il progetto e di poter accedere ad Analytics come descritto in Guida introduttiva ad Analytics.

Se vuoi raccogliere i dati di attribuzione delle campagne per le app della piattaforma Apple, assicurati di aggiungere il framework AdSupport al tuo progetto.

Eventi dei log

Dopo aver creato un'istanza FirebaseAnalytics, puoi utilizzarla per registrare 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, viaggi e 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 API.

Il seguente esempio 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,
    },
);

Può essere utile se vuoi specificare parametri aggiuntivi diversi da quelli prescritti (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 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, utilizza Analytics > Eventi > Gestisci definizioni personalizzate > Crea dimensioni 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 Esportazione in BigQuery di Google Analytics 4.

  • Parametro value: un parametro per uso generico utile per accumulare una metrica chiave relativa a un evento. Alcuni esempi sono entrate, distanza, tempo e punti.

  • I nomi dei parametri possono contenere fino a 40 caratteri e devono iniziare con un carattere alfabetico e contenere solo caratteri alfanumerici e trattini bassi. Sono supportati i tipi stringa e numerico. I valori dei parametri 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 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 vengano visualizzati nei report di Analytics.

I valori validi dei parametri sono String e num. L'impostazione del valore di una chiave su null cancella il parametro. Il passaggio di un valore nullo cancella tutti i parametri.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

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

Per cancellare un parametro predefinito, chiama il metodo setDefaultEventParameters() con il parametro impostato su null.