Registra eventos


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

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 registrarán 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 crear una instancia de FirebaseAnalytics, puedes usarla para registrar eventos con los métodos log de la biblioteca.

Eventos predefinidos

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.

Puedes encontrar los métodos de registro para los tipos de eventos recomendados en la referencia de la API.

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

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

Como alternativa, puedes registrar el mismo evento con logEvent():

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

Esto puede ser útil si deseas especificar parámetros adicionales además de los prescritos (obligatorios). 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. Luego de 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 > Administrar definiciones personalizadas > Crear dimensiones personalizadas

    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: 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.

  • Los nombres de parámetros pueden tener hasta 40 caracteres y deben comenzar con un carácter alfabético y contener solo caracteres alfanuméricos y guiones bajos. Se admiten tipos de cadena y número. Los valores de los parámetros de cadena pueden tener hasta 100 caracteres. Los prefijos “firebase”, “google” y “ga_” están reservados y no deben utilizarse para nombres de parámetros.

Eventos personalizados

Si tu aplicación tiene necesidades específicas que no están cubiertas por un tipo de evento recomendado, puedes registrar tus propios eventos personalizados como se muestra en este ejemplo:

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

Configura parámetros de eventos predeterminados

Puedes registrar parámetros en los eventos mediante el objeto setDefaultEventParameters(). Los parámetros predeterminados se asocian con todos los eventos futuros que se registran.

Al igual que con los parámetros personalizados, registra los parámetros de eventos predeterminados para asegurarte de que aparezcan en los informes de Analytics.

Los valores de parámetro válidos son cadena y número. Cuando se configura el valor de una clave en null, se borra ese parámetro. Si se pasa un valor nulo, se borran todos los parámetros.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

Si se especifica un parámetro en el método logEvent() o log, se usa ese valor en lugar del predeterminado.

Para borrar un parámetro predeterminado, llama al método setDefaultEventParameters() con el parámetro configurado como null.

Visualiza eventos en el panel

Puedes ver estadísticas globales acerca de tus eventos en los paneles de la consola de Firebase. 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 la consola de Firebase. En este panel, se muestran los informes de eventos que se crean automáticamente para cada tipo distinto de evento que registra tu app.