Comienza a usar Google Analytics

En esta guía de inicio rápido, aprenderás cómo agregar Google Analytics a tu app y comenzar a registrar eventos.

Google Analytics recopila datos de uso y comportamiento de tu app. El SDK registra dos tipos principales de información:

  • Eventos: Lo que sucede en la app, como las acciones de los usuarios, los eventos del sistema o los errores.
  • Propiedades de usuario: Los atributos que defines para describir segmentos de tu 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 que agregues código para habilitarlos.

Antes de comenzar

  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 el proyecto de Firebase:

    • Si quieres crear un nuevo proyecto de Firebase, habilita Google Analytics durante el flujo de trabajo de creación.

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

    Cuando habilitas Google Analytics en tu proyecto, las apps de Firebase se vinculan a los flujos de datos de Google Analytics.

  2. Paso recomendado: Agrega el framework de AdSupport a tu proyecto para habilitar otras funciones como los públicos y la atribución de campañas.

Agrega el SDK de Analytics a tu app

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

  1. En Xcode, con tu proyecto de app abierto, navega a File > Add Packages.
  2. Cuando se te solicite, agrega el repositorio del SDK de Firebase para plataformas de Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Elige la biblioteca de Analytics.
  5. Para obtener una experiencia óptima con Analytics, te recomendamos habilitar Google Analytics en tu proyecto de Firebase y agregar el SDK de Firebase para Google Analytics a la app. Puedes seleccionar la biblioteca sin la colección de IDFA o con la colección de IDFA.
  6. Cuando termines, Xcode comenzará a resolver y descargar automáticamente tus dependencias en segundo plano.

Obtén más información sobre el IDFA, el identificador de publicidad a nivel del dispositivo, en la documentación de Apple sobre el uso de datos y la privacidad de los usuarios y App Tracking Transparency.

A continuación, debes realizar los siguientes pasos de configuración:

  1. Importa el módulo FirebaseCore en tu UIApplicationDelegate, así como cualquier otro módulo de Firebase que use el delegado de la app. Por ejemplo, para usar Cloud Firestore y Authentication:

    SwiftUI

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

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configura una instancia compartida de FirebaseApp en el método application(_:didFinishLaunchingWithOptions:) del delegado de la app:

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Si usas SwiftUI, debes crear un delegado de la aplicación y adjuntarlo al struct de tu App a través de UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor. También debes inhabilitar el swizzling del delegado de la app. Para obtener más información, consulta 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()
          }
        }
      }
    }
          


Inhabilita el registro de atribución de la red de publicidad de Apple (opcional)

Para tu comodidad, el SDK registra automáticamente la app en Apple para la atribución de red de publicidad con SKAdNetwork. Si quieres inhabilitar esta función, configura el valor de GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED como NO (booleano) en el archivo info.plist de la app.

Comienza a registrar eventos

Después de configurar la instancia FirebaseApp, puedes comenzar a registrar eventos con el método logEvent().

Algunos eventos se recomiendan para todas las apps; otros se recomiendan para verticales o tipos de empresas específicos. Debes enviar los eventos sugeridos junto con sus parámetros prescritos a fin de asegurarte de tener la mayor cantidad posible de detalles en tus informes y aprovechar las integraciones y funciones futuras cuando estén disponibles. En esta sección, se muestra cómo registrar un evento predefinido. Para obtener más información sobre el registro de eventos, consulta Registra eventos.

En el siguiente ejemplo, se muestra cómo registrar un evento recomendado para indicar que un usuario hizo clic en un elemento específico de tu app:

Swift

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

Objective-C

Nota: Este producto de Firebase no está disponible en el segmento de 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, habilita la depuración de Analytics:

  1. En Xcode, selecciona Product > Scheme > Edit scheme…
  2. Selecciona Run en el menú de la izquierda.
  3. Selecciona la pestaña Arguments.
  4. En la sección Arguments Passed On Launch, agrega -FIRAnalyticsDebugEnabled.

Próximos pasos