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
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.
(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.
- In Xcode, con il progetto dell'app aperto, vai a File > Add Packages .
- Quando richiesto, aggiungi il repository SDK delle piattaforme Firebase Apple:
- Scegli la libreria Analytics.
- 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.
- Al termine, Xcode inizierà automaticamente a risolvere e scaricare le tue dipendenze in background.
https://github.com/firebase/firebase-ios-sdk
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:
- Importa il modulo
FirebaseCore
nel tuoUIApplicationDelegate
, 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; // ...
- Configura un'istanza condivisa
FirebaseApp
nel metodoapplication(_: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];
- Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e allegarlo alla struttura
App
tramiteUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. È 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
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Obiettivo-C
[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:
- In Xcode, seleziona Prodotto > Schema > Modifica schema...
- Seleziona Esegui dal menu a sinistra.
- Seleziona la scheda Argomenti .
- Nella sezione Argomenti trasmessi all'avvio , aggiungi
-FIRAnalyticsDebugEnabled
.
Prossimi passi
- Usa DebugView per verificare i tuoi eventi.
- Esplora i tuoi dati nella console Firebase.
- Esplora le guide su eventi e proprietà utente.
- Scopri come esportare i tuoi dati in BigQuery.