Registrar eventos

Con esta guía, aprenderás a registrar eventos en una app.

Los eventos proporcionan información sobre lo que sucede en tu app. Por ejemplo, acciones de los usuarios, eventos del sistema o errores.

Analytics registra automáticamente algunos eventos; no es necesario que agregues código para recibirlos. Si tu app debe recopilar datos adicionales, puedes registrar hasta 500 tipos de eventos de Analytics diferentes en ella. No existen límites para el volumen total de eventos que puede registrar tu app. Ten en cuenta que los nombres de los eventos distinguen mayúsculas de minúsculas y, si se registran dos eventos con nombres iguales que solo difieren en el uso de mayúsculas, se registran dos eventos diferentes.

Antes de comenzar

Asegúrate de que tu proyecto esté configurado y pueda acceder a Analytics como se describe en Comienza a usar Analytics.

Registra eventos

Después de configurar la instancia firebase.analytics(), puedes comenzar a registrar eventos con el método logEvent(). Si estás familiarizado con Google Analytics, este método es equivalente a usar el comando event en gtag.js.

Para ayudarte a comenzar, el SDK de Analytics define una cantidad de eventos recomendados que son comunes entre diferentes tipos de apps, como las de venta minorista y comercio electrónico, viajes y videojuegos. Para obtener más información sobre estos eventos y cuándo usarlos, consulta Eventos recomendados.

Nota: Para obtener el máximo nivel de detalle en los informes, registra los eventos recomendados que sean relevantes para la app junto con sus parámetros prescritos. De esta manera, también te aseguras de aprovechar las funciones más recientes de Google Analytics a medida que comiencen a estar disponibles.

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

En el siguiente ejemplo, se muestra cómo registrar un evento select_content:

API modular web

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

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

API con espacio de nombres web

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

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

  • Parámetros personalizados: Pueden usarse como dimensiones o métricas en los informes de Analytics. Puedes usar dimensiones personalizadas para los datos de parámetros de evento no numéricos y métricas personalizadas en cualquier dato de parámetro que se represente mejor de forma numérica. Una vez que hayas registrado un parámetro personalizado con el SDK, registra la dimensión o la métrica para asegurarte de que aparezcan los parámetros personalizados en los informes de Analytics. Para ello, ve a Analytics > Eventos > Manage Custom Definitions > Create Custom Dimensions

    Los parámetros personalizados se pueden usar en las definiciones de públicos que se pueden aplicar a cada informe. Los parámetros personalizados también se incluyen en los datos exportados a BigQuery si la app está vinculada a un proyecto de BigQuery. Encuentra consultas de muestra y mucho más en BigQuery Export de Google Analytics 4.

  • Parámetro value: value es un parámetro de uso general que resulta útil para acumular una métrica clave relacionada con un evento. Entre los ejemplos, se incluyen los ingresos, la distancia, el tiempo y los puntos.

Si la aplicación tiene necesidades específicas que no están cubiertas por un tipo de evento recomendado, puedes registrar tus propios eventos personalizados. Por ejemplo, si desarrollas un videojuego y quieres hacer un seguimiento cuando un jugador complete un objetivo en particular, podrías registrar un evento similar al siguiente ejemplo:

API modular web

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

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

API con espacio de nombres web

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

Visualiza eventos en el panel

Puedes ver estadísticas globales acerca de tus eventos en los paneles de Firebase console. Estos paneles se actualizan periódicamente durante el día. Para hacer pruebas inmediatas, usa la salida del logcat como se describe en la sección anterior.

Puedes acceder a los datos en el panel Eventos de Firebase console. En este panel, se muestran los informes de eventos que se crean automáticamente para cada tipo distinto de evento que registra tu app.