Registra eventi

Seleziona la piattaforma:

iOS+ Android Web Flutter Unity C++

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 tipi di eventi Analytics diversi nella tua app. Non esiste un limite al volume totale di eventi registrati dalla tua app. Tieni presente che i nomi evento sono sensibili alle maiuscole e che la registrazione di due eventi i cui nomi differiscono solo per l'uso delle maiuscole genera due eventi distinti.

Prima di iniziare

Assicurati di aver configurato il progetto e di poter accedere ad Analytics come descritto in Inizia a utilizzare Analytics.

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

Registra eventi

Dopo aver creato un'istanza FirebaseAnalytics, puoi utilizzarla per registrare gli 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, di viaggi e di giochi. Per scoprire di più su questi eventi e su quando utilizzarli, consulta Eventi consigliati.

Puoi trovare i metodi di registrazione per i tipi di eventi consigliati nel Riferimento API.

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

Questo può essere utile se vuoi specificare parametri aggiuntivi oltre a 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 che è meglio rappresentare numericamente. Dopo aver registrato un parametro personalizzato utilizzando l'SDK, registra la dimensione o la metrica per assicurarti che i 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 BigQuery Export di Google Analytics 4.

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

• I nomi dei parametri possono avere una lunghezza massima di 40 caratteri, devono iniziare con un carattere alfabetico e contenere solo caratteri alfanumerici e trattini bassi. Sono supportati i tipi stringa e numero. 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,
    },
);

Imposta 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 parametro validi sono String e num. Se imposti il valore di una chiave su null, il parametro viene cancellato. Se passi un valore null, tutti i parametri vengono cancellati.

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

Se un parametro viene specificato 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.