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
Si aún no lo has hecho, agrega Firebase a tu proyecto de JavaScript 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
Cuando habilitas Google Analytics en tu proyecto, tus aplicaciones web de Firebase se vinculan a flujos de datos de Google Analytics asociados con una propiedad App + Web .
Agregue el SDK de Analytics a su aplicación
Dependiendo de cómo esté alojada su aplicación web, su configuración puede manejarse automáticamente o puede que necesite actualizar su objeto de configuración de Firebase . Si su aplicación web ya utiliza Google Analytics, es posible que deba realizar una configuración adicional que se describe en Usar Firebase con el etiquetado gtag.js existente .
Verifique que su objeto de configuración de Firebase en su código contenga
measurementId
. Esta ID se crea automáticamente cuando habilitas Analytics en tu proyecto de Firebase y registras una aplicación web, y es necesaria para usar Analytics.Si tu aplicación usa Firebase Hosting y usa URL reservadas para los SDK de Firebase :
Firebase maneja automáticamente la configuración de su aplicación. Para completar la configuración, agregue los scripts de la tarjeta Sus aplicaciones en la configuración de su Proyecto a la etiqueta <body> de su aplicación, si aún no lo ha hecho.
Si su aplicación no usa URL reservadas : si está trabajando con una aplicación web existente , actualice el objeto de configuración de Firebase en su código para asegurarse de que el campo
measurementId
esté presente. El objeto de configuración debería ser similar al siguiente ejemplo:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc", authDomain: "project-id.firebaseapp.com", databaseURL: "https://project-id.firebaseio.com", projectId: "project-id", storageBucket: "project-id.appspot.com", messagingSenderId: "637908496727", appId: "2:637908496727:web:a4284b4c99e329d5", measurementId: "G-9VP01NDSXJ" };
Si aún no lo has hecho, instala el SDK de Firebase JS e inicializa Firebase .
Agregue el SDK de Analytics JS e inicialice Analytics:
API modular web
import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = getAnalytics(app);
API con espacio de nombres web
import firebase from "firebase/compat/app"; import "firebase/compat/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = firebase.analytics();
Usar Firebase con el etiquetado gtag.js existente
Si anteriormente tenías Google Analytics ejecutándose en tu aplicación usando el fragmento de gtag.js , es posible que tu aplicación requiera configuración adicional si planeas realizar una de las siguientes acciones:
- Agregue llamadas de Google Analytics desde Firebase a la página, pero también planee continuar usando llamadas
gtag()
directamente en la misma página. - Quiere utilizar el mismo ID de medición entre las llamadas directas
gtag()
y los datos de Google Analytics enviados a Firebase.
Para garantizar que sus eventos estén disponibles para que todos los servicios de Firebase los utilicen, complete los siguientes pasos de configuración adicionales:
- Elimine la línea
gtag('config', ' GA_MEASUREMENT_ID ');
dondeGA_MEASUREMENT_ID
es elmeasurementId
de su aplicación web Firebase. Si tiene otros ID para otras propiedades de Analytics en la página, no es necesario que elimine su línea de configuración. - Asegúrate de llamar
firebase.analytics()
antes de enviar cualquier evento congtag()
.
De lo contrario, los eventos enviados a ese ID con llamadas gtag()
no se asociarán con Firebase y no estarán disponibles para su segmentación en otros servicios de Firebase.
Comenzar a registrar eventos
Una vez que haya inicializado el servicio Analytics , 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 recibió una notificación en su aplicación:
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web namespaced API
firebase.analytics().logEvent('notification_received');
Próximos pasos
- Comprenda cada informe de Analytics .
- Utilice DebugView para verificar sus eventos.
- Explora tus datos en Firebase console .
- Explore las guías sobre eventos y propiedades de usuario.
- Aprenda a exportar sus datos a BigQuery.