Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Inizia con Google Analytics

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa guida introduttiva 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: ciò che sta accadendo nella tua app, ad esempio azioni dell'utente, eventi di sistema o errori.
  • Proprietà utente: attributi che definisci per descrivere i segmenti della tua base di utenti, come la preferenza della lingua o la posizione geografica.

Analytics registra automaticamente alcuni eventi e proprietà 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 stai utilizzando un progetto Firebase esistente che non ha Google Analytics abilitato, vai alla scheda Integrazioni delle tue > Impostazioni progetto per abilitarlo.

    Quando abiliti Google Analytics nel tuo progetto, le tue app Firebase vengono 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 Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Scegli la libreria Analytics.
  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 delle app di Apple.

Quindi, esegui alcuni passaggi di configurazione:

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate , così come qualsiasi altro modulo Firebase utilizzato dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e l'autenticazione:

    SwiftUI

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

    Rapido

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

    Rapido

    // 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 disabilitare lo scorrimento del delegato dell'app. Per ulteriori informazioni, consulta le istruzioni 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) Disabilita 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 desideri disattivare questa funzione, 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 specifici tipi di attività o verticali. Dovresti inviare gli eventi suggeriti insieme ai loro parametri prescritti, per garantire il massimo dettaglio disponibile nei tuoi report e per beneficiare delle future funzionalità e integrazioni non appena saranno disponibili. Questa sezione illustra la registrazione di un evento predefinito, per ulteriori informazioni sulla registrazione degli eventi, vedere Log events .

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

Rapido

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

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"
                                 }];

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 trasmessi all'avvio, aggiungi -FIRAnalyticsDebugEnabled .

Prossimi passi

,

Questa guida introduttiva 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: ciò che sta accadendo nella tua app, ad esempio azioni dell'utente, eventi di sistema o errori.
  • Proprietà utente: attributi che definisci per descrivere i segmenti della tua base di utenti, come la preferenza della lingua o la posizione geografica.

Analytics registra automaticamente alcuni eventi e proprietà 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 stai utilizzando un progetto Firebase esistente che non ha Google Analytics abilitato, vai alla scheda Integrazioni delle tue > Impostazioni progetto per abilitarlo.

    Quando abiliti Google Analytics nel tuo progetto, le tue app Firebase vengono 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 Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Scegli la libreria Analytics.
  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 delle app di Apple.

Quindi, esegui alcuni passaggi di configurazione:

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate , così come qualsiasi altro modulo Firebase utilizzato dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e l'autenticazione:

    SwiftUI

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

    Rapido

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

    Rapido

    // 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 disabilitare lo scorrimento del delegato dell'app. Per ulteriori informazioni, consulta le istruzioni 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) Disabilita 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 desideri disattivare questa funzione, 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 specifici tipi di attività o verticali. Dovresti inviare gli eventi suggeriti insieme ai loro parametri prescritti, per garantire il massimo dettaglio disponibile nei tuoi report e per beneficiare delle future funzionalità e integrazioni non appena saranno disponibili. Questa sezione illustra la registrazione di un evento predefinito, per ulteriori informazioni sulla registrazione degli eventi, vedere Log events .

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

Rapido

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

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"
                                 }];

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 trasmessi all'avvio, aggiungi -FIRAnalyticsDebugEnabled .

Prossimi passi