Comienza a usar Google Analytics

En esta guía de inicio rápido, aprenderás cómo agregar Google Analytics a tu app y comenzar a registrar eventos.

Google Analytics recopila datos de uso y comportamiento de tu app web. El SDK registra dos tipos principales de información:

  • Eventos: Lo que sucede en la app, como las acciones de los usuarios, los eventos del sistema o los errores.

  • Propiedades del usuario: Los atributos que defines para describir segmentos de la 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 que agregues código para habilitarlos.

Antes de comenzar

En función del tipo de app web con la que trabajas (nueva o existente), puedes vincular Analytics a tu proyecto de Firebase de una de las siguientes maneras:

  • Si quieres un proyecto nuevo, agrega Firebase a tu proyecto de JavaScript y sigue los pasos para configurar Google Analytics en el proyecto de Firebase. Cuando se te solicite, selecciona tu cuenta existente de Google Analytics para vincularla o crea una nueva.
  • Si tienes un proyecto existente y no configuraste Google Analytics, puedes vincular el servicio a tu proyecto en la pestaña Integraciones de Configuración > Configuración del proyecto.
  • Si tienes un proyecto existente con Analytics configurado antes del 31 de julio de 2019 , deberás actualizar a la experiencia completa de Google Analytics de forma gratuita en la pestaña Integraciones de la Configuración del proyecto.

Cuando completes uno de estos pasos, habrás vinculado correctamente tu proyecto de Firebase a un flujo de datos de Google Analytics asociado con una propiedad App + Web.

Agrega el SDK de Analytics a tu app

En función de cómo está alojada tu app web, es posible que la configuración se controle automáticamente o podría ser necesario que agregues o actualices tu objeto de configuración de Firebase. Si tu app web ya usa Google Analytics, es posible que debas aplicar la configuración adicional que se describe en Usa Firebase con el etiquetado gtag.js existente.

  • Si tu app usa Firebase Hosting y URL reservadas para los SDK de Firebase:

    1. Firebase controla automáticamente la configuración de la app. Para completar la configuración, agrega las secuencias de comandos de la tarjeta Tus apps de la Configuración del proyecto a la etiqueta <body> de la app (si aún no lo has hecho).
  • Si tu app no usa URL reservadas:

    1. Agrega el objeto de configuración de la tarjeta Tus apps de la Configuración del proyecto a la etiqueta <body> de tu app.
    2. Si trabajas con una app web existente, actualiza tu objeto de configuración de Firebase para asegurarte de que el campo measurementId esté presente. Debes usar Google Analytics con tu app web. El objeto de configuración debe ser similar al siguiente ejemplo:

      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"
      };
      

Usa Firebase con el etiquetado gtag.js existente

Si antes ejecutabas Google Analytics en tu app con el fragmento gtag.js, es posible que tu app requiera una configuración adicional si piensas realizar una de las siguientes acciones:

  • Agregar llamadas de Google Analytics desde Firebase a la página, pero también planeas seguir usando llamadas a gtag() directamente en la misma página
  • Utilizar el mismo ID de medición entre las llamadas directas de gtag() y los datos de Google Analytics enviados a Firebase

A fin de garantizar que tus eventos estén disponibles para que los utilicen todos los servicios de Firebase, completa los siguientes pasos de configuración adicionales:

  • Quita [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) de la URL. Tu fragmento de gtag debería ser similar a esto:

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • Quita la línea gtag('config', 'GA_MEASUREMENT_ID');, en la que GA_MEASUREMENT_ID es igual que measurementId en tu fragmento de configuración de Firebase. Si tienes otros ID para otras propiedades de Analytics en la página, no es necesario que quites su línea de configuración.

  • Asegúrate de llamar a firebase.analytics() antes de enviar eventos con gtag().

De lo contrario, los eventos enviados a ese ID con llamadas de gtag() no se asociarán con Firebase y no estarán disponibles como destino en otros servicios de Firebase.

Comienza a registrar eventos

Después de crear una referencia al servicio de Analytics con 'firebase.analytics()', puedes comenzar a registrar eventos con el método 'logEvent()'.

Algunos eventos se recomiendan para todas las apps; otros se recomiendan para verticales o tipos de empresas específicos. Debes enviar los eventos sugeridos junto con sus parámetros prescritos a fin de asegurarte de tener la mayor cantidad posible de detalles en tus informes y aprovechar las integraciones y funciones futuras cuando estén disponibles. En esta sección, se muestra cómo registrar un evento predefinido. Para obtener más información sobre cómo registrar eventos, consulta Registra eventos.

En el siguiente ejemplo, se muestra cómo registrar un evento recomendado para indicar que un usuario recibió una notificación en tu app:

firebase.analytics().logEvent('notification_received');

Pasos siguientes