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 > 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
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' }
Declara el objeto
com.google.firebase.analytics.FirebaseAnalytics
en la parte superior de tu actividad:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Inicialízalo en el método
onCreate()
:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
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.
Kotlin+KTX
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Java
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);
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.
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 > 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
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' }
Declara el objeto
com.google.firebase.analytics.FirebaseAnalytics
en la parte superior de tu actividad:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Inicialízalo en el método
onCreate()
:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
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.
Kotlin+KTX
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Java
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);
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.