Iniziare a utilizzare Google Analytics


Questa guida rapida mostra 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 della lingua o la posizione geografica.

Analytics registra automaticamente alcuni eventi e proprietà utente; non devi aggiungere alcun codice per abilitarli.

Prima di iniziare

  1. Se non l'hai ancora fatto, aggiungi Firebase al tuo progetto Apple e assicurati che Google Analytics sia abilitato nel tuo progetto Firebase:

    • Se crei un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.

    • Se utilizzi un progetto Firebase esistente in cui non è abilitato Google Analytics, vai alla scheda Integrazioni di > Impostazioni progetto per attivarlo.

    Quando attivi Google Analytics nel tuo progetto, le tue app Firebase vengono collegate agli stream di dati di Google Analytics.

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

Aggiungere l'SDK Analytics all'app

Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.

  1. In Xcode, con il progetto dell'app aperto, vai a File > Add Packages (File > Aggiungi pacchetti).
  2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Scegli la raccolta Analytics.
  4. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di build del target.
  5. Per un'esperienza ottimale con Analytics, ti consigliamo di attivare Google Analytics nel tuo progetto Firebase e di aggiungere l'SDK Firebase per Google Analytics alla tua app. Puoi selezionare la libreria senza raccolta dell'IDFA o con raccolta dell'IDFA. Consulta le nostre domande frequenti sull'organizzazione più recente dei moduli in Google Analytics per l'SDK Firebase.
  6. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

Scopri di più su IDFA, l'identificatore pubblicità a livello di dispositivo, nella documentazione di Apple User Privacy and Data Use e App Tracking Transparency.

A questo punto, esegui alcuni passaggi di configurazione:

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate, nonché tutti gli altri moduli Firebase utilizzati dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e Authentication:

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Configura un'istanza condivisa FirebaseApp nel metodo application(_:didFinishLaunchingWithOptions:) del delegato dell'app:

    SwiftUI

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e collegarlo alla struttura App tramite UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor. Devi anche disattivare lo swizzling del delegato dell'app. Per ulteriori informazioni, consulta le istruzioni per SwiftUI.

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}


(Facoltativo) Disattiva la registrazione dell'attribuzione della rete pubblicitaria Apple

Per tua comodità, l'SDK registra automaticamente la tua app con Apple per l'attribuzione della rete pubblicitaria con SKAdNetwork. Se vuoi disattivare questa funzionalità, imposta il valore di GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED su NO (booleano) nel file info.plist della tua app.

Avvia la registrazione degli eventi

Dopo aver configurato l'istanza FirebaseApp, puoi iniziare a registrare gli eventi con il metodo logEvent().

Alcuni eventi sono consigliati per tutte le app; altri sono consigliati per verticali o tipi di attività specifici. Ti consigliamo di inviare gli eventi suggeriti insieme ai relativi parametri obbligatori per garantire il massimo livello di dettagli disponibile nei report e usufruire delle funzionalità e delle integrazioni future non appena diventano disponibili. Questa sezione mostra la registrazione di un evento predefinito. Per ulteriori informazioni sulla registrazione degli eventi, vedi Registrare gli eventi.

L'esempio seguente mostra come registrare un evento consigliato per indicare che un utente ha fatto clic su un elemento specifico nella tua app:

Swift

Nota:questo prodotto Firebase non è disponibile sulla piattaforma di destinazione macOS. 
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Objective-C

Nota:questo prodotto Firebase non è disponibile sulla piattaforma di destinazione macOS. 
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

Per visualizzare questo evento nella console di debug di Xcode, attiva il debug di Analytics:

  1. In Xcode, seleziona Product > Scheme > Edit scheme… (Prodotto > Schema > Modifica schema…).
  2. Seleziona Run (Esegui) dal menu a sinistra.
  3. Seleziona la scheda Arguments (Argomenti).
  4. Nella sezione Arguments Passed On Launch (Argomenti passati al momento dell'avvio), aggiungi -FIRAnalyticsDebugEnabled.

Passaggi successivi