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 web. 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 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
Agregue el SDK de Analytics a su aplicación
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:
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);
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
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.
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()
.
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
logEvent()
.
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.