Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Registrar eventos

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 para usted; no necesita 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 eventos distinguen entre mayúsculas y minúsculas y que registrar dos eventos cuyos nombres difieren solo en mayúsculas y minúsculas dará como resultado dos eventos distintos.

Antes de que empieces

Asegúrese de haber configurado su proyecto y poder acceder a Analytics como se describe en Primeros pasos con Analytics .

Registrar eventos

Una vez que haya configurado la instancia de firebase.analytics() , puede comenzar a registrar eventos con el método logEvent() . Si ya está familiarizado con Google Analytics, este método es equivalente a usar el comando de event en gtag.js.

Para ayudarlo a comenzar, el SDK de Analytics define una serie de eventos recomendados que son comunes entre los diferentes tipos de aplicaciones, incluidas las 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 beneficie de las últimas funciones de Google Analytics a medida que estén disponibles.

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

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

Web version 9

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

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

Web version 8

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

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

  • Parámetros personalizados: los parámetros personalizados se pueden usar como dimensiones o métricas en los informes de Analytics . Puede usar 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 con el SDK, registre la dimensión o la métrica para asegurarse de que esos parámetros personalizados aparezcan en los informes de Analytics. Hágalo a través de: Analytics > Eventos > Administrar definiciones personalizadas > Crear dimensiones personalizadas

    Los parámetros personalizados se pueden usar en 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 su 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 de value : el 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á desarrollando un juego y desea realizar un seguimiento cuando un jugador completa un objetivo en particular, puede registrar un evento similar al siguiente ejemplo:

Web version 9

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

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

Web version 8

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

Ver eventos en el tablero

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

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