Comience con Google Analytics

Flutter web de iOS+ Android

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 Android 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 settings > 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.

Agregue el SDK de Analytics a su aplicación

1. En el archivo Gradle de tu módulo (nivel de aplicación) (generalmente <project>/<app-module>/build.gradle ), agrega la dependencia para la biblioteca de Android de Analytics. Recomendamos usar Firebase Android BoM para controlar el control de versiones de la biblioteca.

   Kotlin+KTX

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:31.2.0')
   
       // Add the dependency for the Analytics library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics-ktx'
   }
   

   Al usar Firebase Android BoM , su aplicación siempre usará versiones compatibles de las bibliotecas de Firebase Android.

   (Alternativa) Agregar dependencias de la biblioteca de Firebase sin usar el BoM

   Si elige no usar Firebase BoM, debe especificar cada versión de la biblioteca de Firebase en su línea de dependencia.

   Tenga en cuenta que si usa varias bibliotecas de Firebase en su aplicación, le recomendamos enfáticamente que use la lista de materiales para administrar las versiones de la biblioteca, lo que garantiza que todas las versiones sean compatibles.

   dependencies {
       // Add the dependency for the Analytics library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0'
   }
   

   Java

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:31.2.0')
   
       // Add the dependency for the Analytics library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics'
   }
   

   Al usar Firebase Android BoM , su aplicación siempre usará versiones compatibles de las bibliotecas de Firebase Android.

   (Alternativa) Agregar dependencias de la biblioteca de Firebase sin usar el BoM

   Si elige no usar Firebase BoM, debe especificar cada versión de la biblioteca de Firebase en su línea de dependencia.

   Tenga en cuenta que si usa varias bibliotecas de Firebase en su aplicación, le recomendamos enfáticamente que use la lista de materiales para administrar las versiones de la biblioteca, lo que garantiza que todas las versiones sean compatibles.

   dependencies {
       // Add the dependency for the Analytics library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics:21.2.0'
   }
   

2. Declara el objeto com.google.firebase.analytics.FirebaseAnalytics en la parte superior de tu actividad:

   Kotlin+KTX

   private lateinit var firebaseAnalytics: FirebaseAnalytics
   MainActivity.kt

   Java

   private FirebaseAnalytics mFirebaseAnalytics;
   MainActivity.java

3. Inicialízalo en el método onCreate() :

   Kotlin+KTX

   // Obtain the FirebaseAnalytics instance.
   firebaseAnalytics = Firebase.analytics
   MainActivity.kt

   Java

   // Obtain the FirebaseAnalytics instance.
   mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
   MainActivity.java

Empezar a registrar eventos

Una vez que haya creado una instancia de FirebaseAnalytics , 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 código registra un evento SELECT_CONTENT cuando un usuario hace clic en un elemento específico de su aplicación.

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

Puede habilitar el registro detallado para monitorear el registro de eventos por parte del SDK para ayudar a verificar que los eventos se registren correctamente. Esto incluye eventos registrados tanto automática como manualmente.

Puede habilitar el registro detallado con una serie de comandos adb :

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Este comando muestra sus eventos en el logcat de Android Studio, lo que lo ayuda a verificar de inmediato que los eventos se envían.

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.

Flutter web de iOS+ Android

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 Android 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 settings > 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.

Agregue el SDK de Analytics a su aplicación

1. En el archivo Gradle de tu módulo (nivel de aplicación) (generalmente <project>/<app-module>/build.gradle ), agrega la dependencia para la biblioteca de Android de Analytics. Recomendamos usar Firebase Android BoM para controlar el control de versiones de la biblioteca.

   Kotlin+KTX

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:31.2.0')
   
       // Add the dependency for the Analytics library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics-ktx'
   }
   

   Al usar Firebase Android BoM , su aplicación siempre usará versiones compatibles de las bibliotecas de Firebase Android.

   (Alternativa) Agregar dependencias de la biblioteca de Firebase sin usar el BoM

   Si elige no usar Firebase BoM, debe especificar cada versión de la biblioteca de Firebase en su línea de dependencia.

   Tenga en cuenta que si usa varias bibliotecas de Firebase en su aplicación, le recomendamos enfáticamente que use la lista de materiales para administrar las versiones de la biblioteca, lo que garantiza que todas las versiones sean compatibles.

   dependencies {
       // Add the dependency for the Analytics library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0'
   }
   

   Java

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:31.2.0')
   
       // Add the dependency for the Analytics library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics'
   }
   

   Al usar Firebase Android BoM , su aplicación siempre usará versiones compatibles de las bibliotecas de Firebase Android.

   (Alternativa) Agregar dependencias de la biblioteca de Firebase sin usar el BoM

   Si elige no usar Firebase BoM, debe especificar cada versión de la biblioteca de Firebase en su línea de dependencia.

   Tenga en cuenta que si usa varias bibliotecas de Firebase en su aplicación, le recomendamos enfáticamente que use la lista de materiales para administrar las versiones de la biblioteca, lo que garantiza que todas las versiones sean compatibles.

   dependencies {
       // Add the dependency for the Analytics library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics:21.2.0'
   }
   

2. Declara el objeto com.google.firebase.analytics.FirebaseAnalytics en la parte superior de tu actividad:

   Kotlin+KTX

   private lateinit var firebaseAnalytics: FirebaseAnalytics
   MainActivity.kt

   Java

   private FirebaseAnalytics mFirebaseAnalytics;
   MainActivity.java

3. Inicialízalo en el método onCreate() :

   Kotlin+KTX

   // Obtain the FirebaseAnalytics instance.
   firebaseAnalytics = Firebase.analytics
   MainActivity.kt

   Java

   // Obtain the FirebaseAnalytics instance.
   mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
   MainActivity.java

Empezar a registrar eventos

Una vez que haya creado una instancia de FirebaseAnalytics , 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 código registra un evento SELECT_CONTENT cuando un usuario hace clic en un elemento específico de su aplicación.

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

Puede habilitar el registro detallado para monitorear el registro de eventos por parte del SDK para ayudar a verificar que los eventos se registren correctamente. Esto incluye eventos registrados tanto automática como manualmente.

Puede habilitar el registro detallado con una serie de comandos adb :

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Este comando muestra sus eventos en el logcat de Android Studio, lo que lo ayuda a verificar de inmediato que los eventos se envían.

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.