Iniziare a utilizzare Google Analytics per Flutter

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


Questa guida rapida mostra come aggiungere Google Analytics alla tua app e iniziare a registrare gli eventi.

Google Analytics raccoglie i dati sull'utilizzo e i dati comportamentali per la tua app. L'SDK registra due tipi principali di informazioni:

  • Eventi:cosa sta succedendo nella tua app, ad esempio azioni degli utenti, eventi di sistema o errori.
  • Proprietà utente:attributi che definisci per descrivere i segmenti della tua base utenti, come la preferenza sulla lingua o la posizione geografica.

Analytics registra automaticamente alcuni eventi e proprietà utente; per attivarli non è necessario aggiungere alcun codice.

Prima di iniziare

  1. Se non l'hai ancora fatto, installa firebase_core e aggiungi il codice di inizializzazione alla tua app.

  2. Registra la tua app nel progetto Firebase utilizzando la console Firebase.

  3. (Consigliato) Aggiungi il framework AdSupport al tuo progetto per attivare funzionalità aggiuntive, come i segmenti di pubblico e l'attribuzione delle campagne.

Aggiungi l'SDK Analytics alla tua app

  1. Dalla directory principale del progetto Flutter, esegui questo comando per installare il plug-in:

    flutter pub add firebase_analytics

  2. Al termine, ricrea l'applicazione Flutter:

    flutter run

  3. Una volta installato, puoi accedere al plug-in firebase_analytics importandolo nel codice Dart:

    import 'package:firebase_analytics/firebase_analytics.dart';

  4. Crea una nuova istanza di Firebase Analytics accedendo alla proprietà instance su FirebaseAnalytics:

    FirebaseAnalytics analytics = FirebaseAnalytics.instance;

Inizia a registrare gli eventi

Dopo aver creato un'istanza FirebaseAnalytics, puoi iniziare a registrare gli eventi con i metodi log- della libreria.

Alcuni eventi sono consigliati per tutte le app, altri per tipi di attività o verticali specifici. Per garantire il livello massimo di dettagli disponibile nei report e usufruire delle funzionalità e delle integrazioni future non appena disponibili, ti suggeriamo di inviare gli eventi consigliati insieme ai relativi parametri prescritti. Questa sezione mostra come registrare un evento predefinito. Per saperne di più sulla registrazione degli eventi, consulta Registra eventi.

Il seguente codice registra un evento di pagamento:

await FirebaseAnalytics.instance
  .logBeginCheckout(
    value: 10.0,
    currency: 'USD',
    items: [
      AnalyticsEventItem(
        itemName: 'Socks',
        itemId: 'xjw73ndnw',
        price: '10.0'
      ),
    ],
    coupon: '10PERCENTOFF'
  );

Passaggi successivi