En esta guía de migración, se describen las novedades de la versión 2 del SDK y se proporcionan sugerencias a los desarrolladores para migrar desde una implementación de la versión 1.x. Los desarrolladores que no necesiten migrar desde una implementación de la versión 1.x pueden comenzar con la versión 2 ahora.
Introducción
Hace poco, Google Analytics lanzó la versión 2 del SDK de Google Analytics para Android. La versión 2 del SDK incluye compatibilidad con funciones nuevas y una nueva interfaz de informes diseñada específicamente para desarrolladores de apps.
Recomendamos que todos los desarrolladores existentes de Google Analytics migren a la versión 2 del SDK de Google Analytics para Android para aprovechar los informes y las funciones nuevos.
Novedades de la versión 2
La versión 2 del SDK de Google Analytics para Android incluye una nueva experiencia de generación de informes diseñada para desarrolladores de apps, nuevas dimensiones y métricas potentes, y mucho más. Esto es lo que obtienen los desarrolladores con la versión 2:
- Informes más útiles para los desarrolladores de apps
- Los informes estándares se rediseñaron para los desarrolladores de apps y se agregaron nuevos informes, como el flujo de participación y las fuentes de Google Play, para ayudar a los desarrolladores a obtener nuevas estadísticas sobre la adquisición y la experiencia de los usuarios. Lee nuestras prácticas recomendadas para la configuración de la cuenta a fin de obtener más información sobre la mejor manera de configurar tu propiedad para la versión 2.
- Nuevas dimensiones y métricas de la aplicación
- Con la versión 2 del SDK, se introdujeron nuevas dimensiones y métricas específicas para apps, que incluyen el nombre y las vistas de pantalla, el nombre de la app y la versión de la app, entre otras.
- Mide las fallas y las excepciones
- El SDK de Google Analytics para Android incluye la medición de excepciones y el tipo de hit de excepción. Con la medición de excepciones, puedes medir la cantidad y el tipo de fallas y excepciones recuperables. Si deseas obtener información para implementar la medición de excepciones, consulta la Guía para desarrolladores de excepciones.
- Dimensiones y métricas personalizadas
- Crea dimensiones personalizadas para segmentar tus datos de nuevas formas. Obtén más información sobre dimensiones y métricas personalizadas.
- Mide las interacciones sociales
- Obtén nuevas estadísticas sobre el valor de las redes sociales en tu app midiendo las interacciones de los usuarios con widgets y complementos sociales incorporados. Obtén más información para medir las interacciones sociales.
Antes de comenzar
Todos los desarrolladores querrán seguir estos dos pasos antes de comenzar su migración:
- Descargar el SDK de Google Analytics para Android v2
- Crea una vista (perfil) de app que usarás para acceder a tus nuevos informes y datos de apps.
Una vez que hayas completado los pasos anteriores, sigue los que se indican a continuación para tu ruta de migración.
Cómo migrar desde EasyTracker
Te recomendamos que sigas tres pasos para migrar tu app de la versión 1 a la 2 de la biblioteca de EasyTracker:
- Actualiza los parámetros en el archivo de recursos GoogleAnalytics.xml
- Actualiza los nombres de los métodos
- Cómo actualizar el receptor de emisión (seguimiento de campañas de Google Play)
1. Actualiza parámetros en GoogleAnalytics.xml
Cuando migres a la versión 2, actualiza los parámetros en el archivo de recursos GoogleAnalytics.xml, ya que algunos cambiaron desde la versión 1.x y se agregaron parámetros nuevos en la versión 2.
En la siguiente tabla, se muestran los parámetros que se actualizaron en la versión 2:
| Nombre del parámetro de la versión 1.x | Nombre del parámetro de la versión 2.x |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | obsoleto |
Para obtener más información, consulta los parámetros nuevos y actualizados de EasyTracker.
2. Actualizar nombres de métodos
Aunque gran parte de la sintaxis de la versión 2 de EasyTracker se mantiene igual, existen algunas diferencias notables en los nombres de los métodos y la sintaxis que requerirán que actualices tu implementación:
trackPageView()essendView()en la versión 2. Para obtener más información, consulta la Guía para desarrolladores de Seguimiento de pantalla- Se simplificó la implementación en el comercio electrónico. Obtén información para implementar la medición de comercio electrónico en la versión 2.
- Las variables personalizadas se reemplazaron por dimensiones y métricas personalizadas. Todas las llamadas a
setCustomVar()deben actualizarse para aprovechar la nueva función. Aprende a implementar dimensiones y métricas personalizadas.
3. Actualiza el receptor de emisión (seguimiento de campañas de Google Play)
Los desarrolladores que implementaron el seguimiento de campañas de Google Play con la versión 1.x deberían tener en cuenta que cambió la ruta de clase del receptor. Consulta la Guía de seguimiento de campañas de Google Play para obtener más información.
Migra desde una implementación personalizada
Si no usabas la biblioteca de EasyTracker en la versión 1.x del SDK de Analytics para Android, te recomendamos que comiences a usar EasyTracker en la versión 2.
La biblioteca de EasyTracker ahora se incluye con el SDK y es la recomendada para todos los desarrolladores. Comienza a usar EasyTracker en el SDK de Google Analytics versión 2.
Si tienes necesidades avanzadas de recopilación de datos, como el uso de varios ID de propiedad en una sola implementación, lee la Guía de configuración avanzada para obtener más información sobre el uso de las funciones avanzadas de la versión 2.x del SDK.