Este inicio rápido le muestra cómo agregar Google Analytics a su aplicación y comenzar a registrar eventos.
Google Analytics recopila datos de uso y comportamiento de su aplicación. El SDK registra dos tipos principales de información:
- Eventos: lo que sucede en su aplicación, como acciones del usuario, eventos del sistema o errores.
- Propiedades de usuario: atributos que define para describir segmentos de su base de usuarios, como la preferencia de idioma o la ubicación geográfica.
Analytics registra automáticamente algunos eventos y propiedades de usuario ; no necesita agregar ningún código para habilitarlos.
Antes de que empieces
Si aún no lo ha hecho, agregue Firebase a su proyecto de Apple y asegúrese de que Google Analytics esté habilitado en su proyecto de Firebase:
Si está creando un nuevo proyecto de Firebase, habilite Google Analytics durante el flujo de trabajo de creación del proyecto.
Si está utilizando un proyecto de Firebase existente que no tiene habilitado Google Analytics, vaya a la pestaña Integraciones de su > Configuración del proyecto para habilitarlo.
Cuando habilita Google Analytics en su proyecto, sus aplicaciones de Firebase se vinculan a los flujos de datos de Google Analytics.
(Recomendado) . Agregue el marco AdSupport a su proyecto para habilitar funciones adicionales, como audiencias y atribución de campañas.
Agregue el SDK de Analytics a su aplicación
Use Swift Package Manager para instalar y administrar las dependencias de Firebase.
- En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
- Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:
- Elija la biblioteca de análisis.
- Para una experiencia óptima con Analytics, recomendamos habilitar Google Analytics en su proyecto de Firebase y agregar el SDK de Firebase para Google Analytics a su aplicación. Puede seleccionar la biblioteca sin colección IDFA o con colección IDFA.
- Cuando termine, Xcode comenzará a resolver y descargar automáticamente sus dependencias en segundo plano.
https://github.com/firebase/firebase-ios-sdk
Obtenga más información sobre IDFA, el identificador de publicidad a nivel de dispositivo, en la documentación de Privacidad de usuario y uso de datos y Transparencia de seguimiento de aplicaciones de Apple.
A continuación, realice algunos pasos de configuración:
- Importe el módulo
FirebaseCore
en suUIApplicationDelegate
, así como cualquier otro módulo de Firebase que use el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Rápido
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
C objetivo
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configure una instancia compartida de
FirebaseApp
en el métodoapplication(_:didFinishLaunchingWithOptions:)
del delegado de su aplicación:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Rápido
// Use Firebase library to configure APIs FirebaseApp.configure()
C objetivo
// Use Firebase library to configure APIs [FIRApp configure];
- Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de
App
a travésUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. También debe deshabilitar el intercambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(Opcional) Deshabilitar el registro de atribución de la red publicitaria de Apple
Para su comodidad, el SDK registra automáticamente su aplicación con Apple para la atribución de redes publicitarias con SKAdNetwork . Si desea desactivar esta función, establezca el valor de GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
en NO
(booleano) en el archivo info.plist de su aplicación.
Empezar a registrar eventos
Una vez que haya configurado la instancia de FirebaseApp
, puede comenzar a registrar eventos con el método logEvent()
.
Se recomiendan ciertos eventos para todas las aplicaciones ; otros se recomiendan para tipos de negocios o verticales específicos. Debe enviar eventos sugeridos junto con sus parámetros prescritos, para garantizar el máximo detalle disponible en sus informes y beneficiarse de futuras funciones e integraciones a medida que estén disponibles. Esta sección demuestra el registro de un evento predefinido. Para obtener más información sobre el registro de eventos, consulte Eventos de registro .
El siguiente ejemplo demuestra cómo registrar un evento recomendado para indicar que un usuario ha hecho clic en un elemento específico de su aplicación:
Rápido
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
C objetivo
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
Para ver este evento en la consola de depuración de Xcode, habilite la depuración de Analytics:
- En Xcode, seleccione Producto > Esquema > Editar esquema...
- Seleccione Ejecutar en el menú de la izquierda.
- Seleccione la pestaña Argumentos .
- En la sección Argumentos pasados al iniciar, agregue
-FIRAnalyticsDebugEnabled
.
Próximos pasos
- Utilice DebugView para verificar sus eventos.
- Explora tus datos en Firebase console.
- Explore las guías sobre eventos y propiedades de usuario.
- Obtén información sobre cómo exportar tus datos a BigQuery.
Este inicio rápido le muestra cómo agregar Google Analytics a su aplicación y comenzar a registrar eventos.
Google Analytics recopila datos de uso y comportamiento de su aplicación. El SDK registra dos tipos principales de información:
- Eventos: lo que sucede en su aplicación, como acciones del usuario, eventos del sistema o errores.
- Propiedades de usuario: atributos que define para describir segmentos de su base de usuarios, como la preferencia de idioma o la ubicación geográfica.
Analytics registra automáticamente algunos eventos y propiedades de usuario ; no necesita agregar ningún código para habilitarlos.
Antes de que empieces
Si aún no lo ha hecho, agregue Firebase a su proyecto de Apple y asegúrese de que Google Analytics esté habilitado en su proyecto de Firebase:
Si está creando un nuevo proyecto de Firebase, habilite Google Analytics durante el flujo de trabajo de creación del proyecto.
Si está utilizando un proyecto de Firebase existente que no tiene habilitado Google Analytics, vaya a la pestaña Integraciones de su > Configuración del proyecto para habilitarlo.
Cuando habilita Google Analytics en su proyecto, sus aplicaciones de Firebase se vinculan a los flujos de datos de Google Analytics.
(Recomendado) . Agregue el marco AdSupport a su proyecto para habilitar funciones adicionales, como audiencias y atribución de campañas.
Agregue el SDK de Analytics a su aplicación
Use Swift Package Manager para instalar y administrar las dependencias de Firebase.
- En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
- Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:
- Elija la biblioteca de análisis.
- Para una experiencia óptima con Analytics, recomendamos habilitar Google Analytics en su proyecto de Firebase y agregar el SDK de Firebase para Google Analytics a su aplicación. Puede seleccionar la biblioteca sin colección IDFA o con colección IDFA.
- Cuando termine, Xcode comenzará a resolver y descargar automáticamente sus dependencias en segundo plano.
https://github.com/firebase/firebase-ios-sdk
Obtenga más información sobre IDFA, el identificador de publicidad a nivel de dispositivo, en la documentación de Privacidad de usuario y uso de datos y Transparencia de seguimiento de aplicaciones de Apple.
A continuación, realice algunos pasos de configuración:
- Importe el módulo
FirebaseCore
en suUIApplicationDelegate
, así como cualquier otro módulo de Firebase que use el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Rápido
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
C objetivo
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configure una instancia compartida de
FirebaseApp
en el métodoapplication(_:didFinishLaunchingWithOptions:)
del delegado de su aplicación:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Rápido
// Use Firebase library to configure APIs FirebaseApp.configure()
C objetivo
// Use Firebase library to configure APIs [FIRApp configure];
- Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de
App
a travésUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. También debe deshabilitar el intercambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(Opcional) Deshabilitar el registro de atribución de la red publicitaria de Apple
Para su comodidad, el SDK registra automáticamente su aplicación con Apple para la atribución de redes publicitarias con SKAdNetwork . Si desea desactivar esta función, establezca el valor de GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
en NO
(booleano) en el archivo info.plist de su aplicación.
Empezar a registrar eventos
Una vez que haya configurado la instancia de FirebaseApp
, puede comenzar a registrar eventos con el método logEvent()
.
Se recomiendan ciertos eventos para todas las aplicaciones ; otros se recomiendan para tipos de negocios o verticales específicos. Debe enviar eventos sugeridos junto con sus parámetros prescritos, para garantizar el máximo detalle disponible en sus informes y beneficiarse de futuras funciones e integraciones a medida que estén disponibles. Esta sección demuestra el registro de un evento predefinido. Para obtener más información sobre el registro de eventos, consulte Eventos de registro .
El siguiente ejemplo demuestra cómo registrar un evento recomendado para indicar que un usuario ha hecho clic en un elemento específico de su aplicación:
Rápido
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
C objetivo
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
Para ver este evento en la consola de depuración de Xcode, habilite la depuración de Analytics:
- En Xcode, seleccione Producto > Esquema > Editar esquema...
- Seleccione Ejecutar en el menú de la izquierda.
- Seleccione la pestaña Argumentos .
- En la sección Argumentos pasados al iniciar, agregue
-FIRAnalyticsDebugEnabled
.
Próximos pasos
- Utilice DebugView para verificar sus eventos.
- Explora tus datos en Firebase console.
- Explore las guías sobre eventos y propiedades de usuario.
- Obtén información sobre cómo exportar tus datos a BigQuery.