En este documento, se describe cómo comenzar a usar el SDK de Google Analytics para Android v3.
Antes de comenzar
Antes de implementar el SDK, asegúrate de tener lo siguiente:
- SDK de desarrollador de Android (disponible para Windows, Mac OS X y Linux)
- SDK de Google Analytics para Android v3 (con
libGoogleAnalyticsServices.jar
incluido en la ruta de compilación y el directorio/libs
de tu proyecto) - Una app para Android que puedes usar a fin de implementar Google Analytics
- Al menos una propiedad y una vista de app (perfil) de Google Analytics a las que deseas enviar datos desde tu app
Cómo comenzar
Hay tres pasos para comenzar a usar el SDK:
Después de completar estos pasos, podrás medir lo siguiente con Google Analytics:
- Instalaciones de la aplicación
- Usuarios activos y datos demográficos
- Pantallas y participación del usuario
- Bloqueos y excepciones
1. Actualizando AndroidManifest.xml
Agrega los siguientes permisos para actualizar el archivo AndroidManifest.xml
:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. Cómo agregar métodos de EasyTracker
Agrega los métodos de envío a los métodos onStart()
y onStop()
de cada uno de tus Activities
, como en el siguiente ejemplo:
package com.example.app; import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; /** * An example Activity using Google Analytics and EasyTracker. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance(this).activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance(this).activityStop(this); // Add this method. } }
3. Cómo crear su archivo analytics.xml
Cuando usas EasyTracker, los ajustes de configuración global se administran con recursos definidos en XML. Crea un archivo llamado analytics.xml
en el directorio res/values
de tu proyecto y agrega los siguientes recursos:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--Replace placeholder ID with your tracking ID--> <string name="ga_trackingId">UA-XXXX-Y</string> <!--Enable automatic activity tracking--> <bool name="ga_autoActivityTracking">true</bool> <!--Enable automatic exception tracking--> <bool name="ga_reportUncaughtExceptions">true</bool> </resources>
Tu verificador de lint puede advertirte sobre el uso del guion gráfico ('') en tu ID de seguimiento. Puedes suprimir esa advertencia agregando atributos adicionales a tu etiqueta <resources>
:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
Consulta la referencia de parámetros de analytics.xml a fin de obtener una lista completa de los parámetros que puedes usar para configurar tu implementación. Según los requisitos de tu aplicación, es posible que desees cambiar el período de envío para verificar que envíes hits correctamente. Por ejemplo, si deseas ver datos en tiempo real, puedes establecerlo en un valor bajo, como 5.
¡Felicitaciones! La app ya está configurada para enviar datos a Google Analytics.
Próximos pasos
Puedes hacer mucho más con Google Analytics, como la medición de campañas, los pagos y las transacciones integrados en la app y los eventos de interacción de los usuarios.
Las siguientes guías para desarrolladores proporcionan detalles adicionales sobre cómo implementar funciones de Google Analytics en tu app:
- Medición de eventos: Obtén información sobre cómo medir la participación de los usuarios con contenido interactivo, como botones, videos y otro contenido multimedia, mediante eventos.
- Medición de pagos integrados en la aplicación: Obtén información sobre cómo medir los pagos integrados en la aplicación y las transacciones.
- Medición de campañas: Obtén información sobre cómo implementar la medición de campañas para comprender qué canales y campañas generan instalaciones de aplicaciones.
- Tiempos de usuario: Obtén información sobre cómo medir los tiempos de los usuarios en tu app para medir los tiempos de carga, la participación con contenido multimedia y mucho más.
- Configuración avanzada: Obtén más información sobre las opciones de configuración avanzada, incluido el uso de varios rastreadores.
-
Parámetros de Analytics.xml: Consulta la lista completa de parámetros de configuración de
analytics.xml
.