Primeros pasos con Google Analytics para C++

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 del 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. Abre el proyecto en Firebase console.
  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 registrado en la app. Obtén más información sobre el panel de informes de Analytics en el Centro de ayuda de Firebase.

Para ayudarte a comenzar, el SDK de Analytics define varios eventos sugeridos 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 acerca de estos eventos y el momento en que deben usarse, consulta los artículos sobre eventos y propiedades del Centro de ayuda de Firebase. Para obtener el máximo nivel de detalle en los informes, registra los eventos sugeridos de Analytics que sean relevantes para tu app y 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.

Antes de comenzar

Sigue estos pasos para usar Google Analytics:

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

    Si el proyecto de C++ ya usa Firebase, significa que ya está registrado y configurado para esa plataforma.

  • En el archivo build.gradle de nivel de proyecto, asegúrate de incluir el repositorio Maven de Google en las secciones buildscript y allprojects.

  • Agrega el SDK de Firebase C++ al proyecto de C++.

Ten en cuenta que agregar Firebase a un proyecto de C++ implica realizar tareas en Firebase console y en el proyecto abierto de C++ (por ejemplo, descargar archivos de configuración de Firebase desde la consola y transferirlos al proyecto de C++).

Crea y, luego, inicializa la app de Firebase

Antes de comenzar, deberás crear la app de Firebase e inicializarla:

Android

Para crear la app de Firebase, pasa como argumentos el entorno de JNI y una referencia de jobject a la actividad de Java:

app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

Inicializa la biblioteca de Analytics con el siguiente comando:

::firebase::analytics::Initialize(app);

iOS

Crea la app de Firebase:

app = ::firebase::App::Create(::firebase::AppOptions());

Inicializa la biblioteca de Analytics con el siguiente comando:

::firebase::analytics::Initialize(app);

Registra eventos

Después de configurar la instancia de firebase::App, puedes comenzar a registrar eventos con el método LogEvent().

En el siguiente ejemplo, se actualiza la puntuación del usuario:

analytics::LogEvent(analytics::kEventPostScore, analytics::kParameterScore, 42);

Próximos pasos