En este documento, se describe una versión heredada del SDK de Android. Si es la primera vez que usas Analyitcs, usa el SDK más reciente. Más información

SDK de Google Analytics para Android v2 (heredado): descripción general

El SDK de Google Analytics para Android facilita a los desarrolladores recopilar datos de participación de los usuarios de sus apps. En este documento, se proporciona una descripción general del valor del SDK y una guía para comenzar a medir tu app con un solo ID de propiedad y EasyTracker.

Introducción

El SDK de Google Analytics para Android facilita que los desarrolladores recopilen datos de participación de los usuarios de sus apps. Los desarrolladores pueden usar los informes de Google Analytics para medir lo siguiente:

  • La cantidad de usuarios activos que usan sus aplicaciones.
  • En qué parte del mundo se usa la aplicación.
  • Adopción y uso de funciones específicas.
  • Transacciones y compras directas desde la aplicación
  • La cantidad y el tipo de fallas de la aplicación
  • Y muchas otras métricas útiles.

Además, el SDK de Google Analytics para Android te brinda las herramientas para supervisar el éxito de las campañas de marketing para dispositivos móviles, ya que proporciona visibilidad de extremo a extremo del rendimiento de tus canales de marketing, desde las instalaciones de Google Play hasta las compras directas desde la aplicación y las transacciones.

Antes de comenzar

Antes de comenzar a implementar el SDK, asegúrate de tener lo siguiente:

Cómo comenzar

Hay tres pasos para comenzar a usar el SDK:

  1. Actualiza AndroidManifest.xml
  2. Cómo agregar métodos de EasyTracker
  3. Cree su archivo analytics.xml

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

Para actualizar tu archivo AndroidManifest.xml, agrega los siguientes permisos:

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

/**
 * An example Activity in your app with Analytics
 * implemented.
 */
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().activityStart(this); // Add this method.
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // The rest of your onStop() code.
    EasyTracker.getInstance().activityStop(this); // Add this method.
  }
}

Ten en cuenta que EasyTracker requiere Context antes de que puedas llamar a sus métodos. En el ejemplo anterior, esta línea: 

EasyTracker.getInstance.activityStart(this);

se encarga de establecer el contexto. Sin embargo, si necesitas realizar llamadas de EasyTracker en otras clases o métodos, primero deberás llamar al método setContext(Context ctx) de EasyTracker:

// Set Context before using EasyTracker. Note that the SDK will
// use the application context.
EasyTracker.getInstance().setContext(this);

// EasyTracker is now ready for use.

3. Cómo crear su archivo analytics.xml

En la versión 2 del SDK de Google Analytics para Android, las opciones de configuración se administran desde un archivo de recursos XML, denominado analytics.xml en esta guía. Deberás crear este archivo en el directorio res/values de tu proyecto y agregar tu ID de seguimiento. En el siguiente ejemplo, se muestra cómo puedes agregar tu ID de seguimiento y habilitar Activity y la medición de excepciones:

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

¡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. Consulta las siguientes guías para desarrolladores a fin de obtener información sobre cómo agregar estas funciones a tu implementación:

  • Configuración avanzada: Obtén más información sobre las opciones de configuración avanzada, incluido el uso de varios rastreadores.
  • 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.
  • 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.
  • 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.
  • Parámetros de Analytics.xml: Consulta la lista completa de parámetros de configuración de analytics.xml.