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

Comience con Google Analytics

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

  1. 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.

  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

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

  1. En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
  2. Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Elija la biblioteca de análisis.
  4. 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.
  5. Cuando termine, Xcode comenzará a resolver y descargar automáticamente 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 de usuario y uso de datos y Transparencia de 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 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;
// ...
  2. Configure una instancia compartida de FirebaseApp en el método application(_: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];
  3. Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de App a través UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . 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

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

C objetivo

Nota: Este producto de Firebase no está disponible en el objetivo de macOS.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

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 ​​al iniciar, agregue -FIRAnalyticsDebugEnabled .

Próximos pasos

,

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

  1. 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.

  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

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

  1. En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
  2. Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Elija la biblioteca de análisis.
  4. 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.
  5. Cuando termine, Xcode comenzará a resolver y descargar automáticamente 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 de usuario y uso de datos y Transparencia de 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 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;
// ...
  2. Configure una instancia compartida de FirebaseApp en el método application(_: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];
  3. Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de App a través UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . 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

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

C objetivo

Nota: Este producto de Firebase no está disponible en el objetivo de macOS.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

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 ​​al iniciar, agregue -FIRAnalyticsDebugEnabled .

Próximos pasos