Primeros pasos con Google Analytics para Unity

Google Analytics recopila datos de uso y comportamiento de tu app. 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 de usuario: Los atributos que defines para describir segmentos de tu 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. Si necesitas recopilar datos adicionales para la app, puedes configurar hasta 25 propiedades de usuario de Analytics diferentes y registrar hasta 500 tipos distintos de eventos de Analytics en la app. No existen límites para el volumen total de eventos que registra la app.

Para acceder a estos datos, haz lo siguiente:

  1. En Firebase console, abre tu proyecto.
  2. Selecciona Analytics en el menú para ver el panel de informes de Analytics.

En la pestaña Eventos, se muestran los informes de eventos que se crean automáticamente para cada tipo de evento de Analytics que registra tu app. Obtén más información sobre el panel.

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. Si quieres obtener el máximo nivel de detalle en los informes, registra los eventos de Analytics sugeridos que sean relevantes para la app y sus parámetros prescritos. De esta manera, también te aseguras de beneficiarte de las funciones más recientes de Google Analytics a medida que estén disponibles.

Antes de comenzar

Antes de poder usar Google Analytics, tendrás que hacer lo siguiente:

  • Registra tu proyecto de Unity y configúralo para usar Firebase.

    • Si tu proyecto de Unity ya usa Firebase, significa que ya está registrado y configurado para Firebase.

    • Si aún no tienes un proyecto de Unity, puedes descargar una app de ejemplo.

  • Agrega el SDK de Firebase Unity (específicamente, FirebaseAnalytics.unitypackage) a tu proyecto de Unity.

Ten en cuenta que agregar Firebase a tu proyecto de Unity implica realizar tareas en Firebase console y en tu proyecto abierto de Unity (por ejemplo, descargar archivos de configuración de Firebase desde la consola y moverlos a tu proyecto de Unity).

Registra eventos

Puedes comenzar a registrar eventos de inmediato con el método LogEvent().

En el siguiente ejemplo, se registran los eventos con diversos tipos de argumentos:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

Próximos pasos