Iniziare a utilizzare Google Analytics

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

Google Analytics raccoglie dati sull'utilizzo e sul comportamento della tua app. L'SDK registra due tipi principali di informazioni:

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

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

Prima di iniziare

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

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

    • Se utilizzi un progetto Firebase esistente su cui non è abilitato Google Analytics, vai alla scheda Integrazioni del tuo > Impostazioni progetto per abilitarlo.

    Quando abiliti Google Analytics nel tuo progetto, le tue app Firebase sono collegate ai flussi di dati di Google Analytics.

  2. (Consigliato) . Aggiungi il framework AdSupport al tuo progetto per abilitare funzionalità aggiuntive come il pubblico e l'attribuzione della campagna.

Aggiungi l'SDK di Analytics alla tua 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 .
  2. Quando richiesto, aggiungi il repository SDK delle piattaforme Apple Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Scegli la libreria Analytics.
  4. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di build del tuo target.
  5. Per un'esperienza ottimale con Analytics, ti consigliamo di abilitare Google Analytics nel tuo progetto Firebase e di aggiungere l'SDK Firebase per Google Analytics alla tua app. È possibile selezionare la libreria senza raccolta IDFA o con raccolta IDFA.
  6. Al termine, Xcode inizierà automaticamente a risolvere e scaricare le tue dipendenze in background.

Scopri di più sull'IDFA, l'identificatore pubblicitario a livello di dispositivo, nella documentazione sulla privacy degli utenti e sull'utilizzo dei dati e sulla trasparenza del monitoraggio delle app di Apple.

Successivamente, esegui alcuni passaggi di configurazione:

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate , così come tutti gli altri moduli Firebase utilizzati dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e l'autenticazione:

    SwiftUI

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

    Veloce

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Obiettivo-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()

    Veloce

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

    Obiettivo-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e allegarlo alla struttura App tramite UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . È inoltre necessario disattivare lo swizzling del delegato dell'app. Per ulteriori informazioni, consulta le istruzioni di 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 alla rete pubblicitaria con SKAdNetwork . Se desideri disabilitare questa funzione, imposta il valore di GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED su NO (Booleano) nel file info.plist della tua app.

Inizia a registrare gli 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 tipi di attività o settori verticali specifici. Dovresti inviare gli eventi suggeriti insieme ai parametri prescritti, per garantire il massimo dettaglio disponibile nei tuoi report e per trarre vantaggio dalle funzionalità e integrazioni future non appena diventano disponibili. Questa sezione illustra la registrazione di un evento predefinito. Per ulteriori informazioni sulla registrazione degli eventi, vedere Registrare 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:

Veloce

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

Obiettivo-C

Nota: questo prodotto Firebase non è disponibile sulla 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, abilita il debug di Analytics:

  1. In Xcode, seleziona Prodotto > Schema > Modifica schema...
  2. Seleziona Esegui dal menu a sinistra.
  3. Seleziona la scheda Argomenti .
  4. Nella sezione Argomenti passati all'avvio aggiungere -FIRAnalyticsDebugEnabled .

Prossimi passi