SDK de Google Analytics para Android v3 (heredado): Introducción

En este documento, se describe cómo comenzar a usar el SDK de Google Analytics para Android versión 3.

Antes de comenzar

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

Cómo comenzar

Para comenzar a usar el SDK, debes seguir los siguientes tres pasos:

  1. Actualiza el archivo AndroidManifest.xml
  2. Cómo agregar métodos de EasyTracker
  3. Crea tu archivo analytics.xml

Después de completar estos pasos, podrás medir lo siguiente con Google Analytics:

  • Instalaciones de apps
  • Usuarios activos y datos demográficos
  • Pantallas y participación de los usuarios
  • Fallas y excepciones

1. Cómo actualizar 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 una 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. Crea tu archivo analytics.xml

Cuando usas EasyTracker, los ajustes de configuración global se administran mediante 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>

Es posible que el revisor lint te advierta sobre el uso del guion gráfico ("-") en tu ID de seguimiento. Para suprimir esa advertencia, agrega atributos adicionales a la etiqueta <resources>:

<resources xmlns:tools="http://schemas.android.com/tools"
tools:ignore="TypographyDashes">

Consulta la referencia de parámetros de analytics.xml para obtener una lista completa de los parámetros que puedes usar para configurar tu implementación. Según los requisitos de tu aplicación, te recomendamos que cambies el período de envío para verificar que estés enviando hits de forma correcta. Por ejemplo, si deseas ver datos en tiempo real, te recomendamos establecerlo en un valor bajo, como 5 s.

¡Felicitaciones! La app ya está configurada para enviar datos a Google Analytics.

Próximos pasos

Google Analytics te permite hacer mucho más, como la medición de campañas, los pagos y transacciones en la app, y los eventos de interacción con los usuarios.

En las siguientes guías para desarrolladores, se 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, a través de Eventos.
  • Cómo medir los pagos integrados en la app: Obtén información sobre cómo medir las transacciones y los pagos integrados en las apps.
  • 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 los usuarios: 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 el 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 segmentos.
  • Parámetros de Analytics.xml: Consulta la lista completa de parámetros de configuración de analytics.xml.