Registrar eventos

Esta guía le muestra cómo registrar eventos en su aplicación.

Los eventos brindan información sobre lo que sucede en su aplicación, como acciones del usuario, eventos del sistema o errores.

Analytics registra automáticamente algunos eventos por usted; No necesitas agregar ningún código para recibirlos. Si su aplicación necesita recopilar datos adicionales, puede registrar hasta 500 tipos de eventos de análisis diferentes en su aplicación. No hay límite en el volumen total de eventos que registra su aplicación. Tenga en cuenta que los nombres de los eventos distinguen entre mayúsculas y minúsculas y que el registro de dos eventos cuyos nombres difieren sólo en mayúsculas y minúsculas da como resultado dos eventos distintos.

Antes de que empieces

Asegúrese de haber configurado su proyecto y de poder acceder a Analytics como se describe en Introducción a Analytics .

Registrar eventos

Una vez que hayas configurado la instancia firebase.analytics() , puedes comenzar a registrar eventos con el método logEvent() . Si ya está familiarizado con Google Analytics, este método equivale a utilizar el comando event en gtag.js.

Para ayudarlo a comenzar, el SDK de Analytics define una serie de eventos recomendados que son comunes entre diferentes tipos de aplicaciones, incluidas aplicaciones minoristas y de comercio electrónico, viajes y juegos. Para obtener más información sobre estos eventos y cuándo usarlos, consulte Eventos recomendados .

Nota: Para obtener el máximo detalle en los informes, registre los eventos recomendados que tengan sentido para su aplicación y sus parámetros prescritos. Esto también garantiza que se beneficiará de las últimas funciones de Google Analytics a medida que estén disponibles.

Puedes encontrar detalles de implementación para varios eventos y sus parámetros en la referencia de eventos de gtag.js.

El siguiente ejemplo demuestra cómo registrar un evento select_content :

Web modular API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});analytics_log_event_params.js

Web namespaced API

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});index.js

Además de los parámetros prescritos, puedes agregar los siguientes parámetros a cualquier evento:

Parámetros personalizados: los parámetros personalizados se pueden utilizar como dimensiones o métricas en los informes de Analytics . Puede utilizar dimensiones personalizadas para datos de parámetros de eventos no numéricos y métricas personalizadas para cualquier dato de parámetro mejor representado numéricamente. Una vez que haya registrado un parámetro personalizado mediante el SDK, registre la dimensión o métrica para asegurarse de que esos parámetros personalizados aparezcan en los informes de Analytics. Haga esto a través de: Analytics > Eventos > Administrar definiciones personalizadas > Crear dimensiones personalizadas
Se pueden utilizar parámetros personalizados en las definiciones de audiencia que se pueden aplicar a cada informe. Los parámetros personalizados también se incluyen en los datos exportados a BigQuery si tu aplicación está vinculada a un proyecto de BigQuery. Encuentre consultas de muestra y mucho más en Google Analytics 4 BigQuery Export .
Parámetro value : value es un parámetro de propósito general que es útil para acumular una métrica clave que pertenece a un evento. Los ejemplos incluyen ingresos, distancia, tiempo y puntos.

Si su aplicación tiene necesidades específicas que no están cubiertas por un tipo de evento recomendado, puede registrar sus propios eventos personalizados. Por ejemplo, si estás desarrollando un juego y quieres realizar un seguimiento de cuándo un jugador completa un objetivo en particular, puedes registrar un evento similar al siguiente ejemplo:

Web modular API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});analytics_log_event_custom_params.js

Web namespaced API

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});index.js

Ver eventos en el panel

Puedes ver estadísticas agregadas sobre tus eventos en los paneles de la consola de Firebase. Estos paneles se actualizan periódicamente a lo largo del día. Para realizar pruebas inmediatas, utilice la salida de logcat como se describe en la sección anterior.

Puede acceder a estos datos desde el panel de Eventos en Firebase console. Este panel muestra los informes de eventos que se crean automáticamente para cada tipo distinto de evento registrado por su aplicación.