Empieza a usar Google Analytics

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: qué sucede en su aplicación, como acciones del usuario, eventos del sistema o errores.
  • Propiedades de usuario: atributos que usted 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 del usuario ; no es necesario agregar ningún código para habilitarlos.

Antes de que empieces

  1. Si aún no lo has hecho, agrega Firebase a tu proyecto de Apple y asegúrate de que Google Analytics esté habilitado en tu proyecto de Firebase:

    • Si estás creando un nuevo proyecto de Firebase, habilita Google Analytics durante el flujo de trabajo de creación del proyecto.

    • Si estás utilizando un proyecto de Firebase existente que no tiene Google Analytics habilitado, ve a la pestaña Integraciones de tu > Configuración del proyecto para habilitarlo.

    Cuando habilitas Google Analytics en tu proyecto, tus aplicaciones de Firebase están vinculadas a flujos de datos de Google Analytics.

  2. (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

Utilice Swift Package Manager para instalar y administrar las dependencias de Firebase.

  1. En Xcode, con el proyecto de su aplicación abierto, navegue hasta Archivo > Agregar paquetes .
  2. Cuando se le solicite, agregue el repositorio SDK de las plataformas Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Elija la biblioteca de Analytics.
  5. Agregue el indicador -ObjC a la sección Otros indicadores del vinculador de la configuración de compilación de su objetivo.
  6. 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.
  7. Cuando termine, Xcode comenzará automáticamente a resolver y descargar sus dependencias en segundo plano.

Obtenga más información sobre IDFA, el identificador de publicidad a nivel de dispositivo, en la documentación de Privacidad del usuario y uso de datos y transparencia del seguimiento de aplicaciones de Apple.

A continuación, realice algunos pasos de configuración:

  1. Importe el módulo FirebaseCore en su UIApplicationDelegate , así como cualquier otro módulo de Firebase que utilice el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:

    Interfaz de usuario rápida

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

    Rápido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    C objetivo

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configure una instancia compartida FirebaseApp en el método application(_:didFinishLaunchingWithOptions:) del delegado de su aplicación:

    Interfaz de usuario rápida

    // 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];
  3. Si está utilizando SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura App mediante UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . También debes desactivar el cambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .

    Interfaz de usuario rápida

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          


(Opcional) Desactivar 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 la red publicitaria 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.

Comenzar a registrar eventos

Una vez que haya configurado la instancia 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 muestra el registro de un evento predefinido; para obtener más información sobre el registro de eventos, consulte Registrar eventos .

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

Nota: Este producto de Firebase no está disponible en el destino macOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

C objetivo

Nota: Este producto de Firebase no está disponible en el destino macOS.
[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:

  1. En Xcode, seleccione Producto > Esquema > Editar esquema...
  2. Seleccione Ejecutar en el menú de la izquierda.
  3. Seleccione la pestaña Argumentos .
  4. En la sección Argumentos pasados ​​en el lanzamiento , agregue -FIRAnalyticsDebugEnabled .

Próximos pasos