Iniziare a utilizzare Google Analytics per Flutter

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

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

Google Analytics raccoglie dati sull'utilizzo e sul comportamento 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 abilitarle 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. Aggiungi la tua app al progetto Firebase nella Console Firebase.

Aggiungere l'SDK Analytics alla tua app

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

    flutter pub add firebase_analytics
    
  2. Al termine, ricompila l'applicazione Flutter:

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

    import 'package:firebase_analytics/firebase_analytics.dart';
    
  4. Crea una nuova istanza di Firebase Analytics accedendo alla instance proprietà su FirebaseAnalytics:

    FirebaseAnalytics analytics = FirebaseAnalytics.instance;
    

Avviare la registrazione degli eventi

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

Alcuni eventi sono consigliati per tutte le app; altri sono consigliati per tipi o verticali di attività specifici. Ti suggeriamo di inviare gli eventi consigliati con i relativi parametri prescritti, per garantire il livello massimo di dettagli disponibile nei report e usufruire delle funzionalità e delle integrazioni future non appena disponibili. Questa sezione mostra la registrazione di un evento predefinito. Per ulteriori informazioni sulla registrazione degli eventi, vedi Registrare gli 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