SDK Google Analytics pour Android: migration de la version 1.x vers la version 2.x

Ce guide de migration décrit les nouveautés de la version 2 du SDK et fournit aux développeurs des conseils pour migrer à partir d'une mise en œuvre de la version 1.x. Les développeurs qui n'ont pas besoin de migrer à partir d'une mise en œuvre de la version 1.x peuvent dès maintenant commencer à utiliser la version 2.

Introduction

Google Analytics a récemment publié le SDK Google Analytics pour Android version 2. La version 2 du SDK est compatible avec de nouvelles fonctionnalités et une nouvelle interface de création de rapports spécialement conçue pour les développeurs d'applications.

Nous recommandons à tous les développeurs Google Analytics existants de migrer vers la version 2 du SDK Google Analytics pour Android afin de bénéficier des nouvelles fonctionnalités et des nouveaux rapports.

Nouveautés de la version 2

Le SDK Google Analytics pour Android version 2 introduit une nouvelle expérience de création de rapports conçue pour les développeurs d'applications, de nouvelles dimensions et métriques performantes, et bien plus encore. Voici les avantages dont bénéficient les développeurs avec la version 2:

Rapports plus performants pour les développeurs d'applications
Les rapports standards ont été repensés pour les développeurs d'applications. Nous y avons ajouté de nouveaux rapports tels que "Flux d'engagement" et "Sources Google Play" pour aider les développeurs à mieux comprendre l'acquisition et l'expérience des utilisateurs. Consultez les bonnes pratiques de configuration du compte pour découvrir comment configurer au mieux votre propriété pour la version 2.
Nouvelles dimensions et métriques d'application
Nous avons ajouté de nouvelles dimensions et métriques propres à l'application dans la version 2 du SDK, y compris "Nom de l'écran et visionnage de l'écran", "Nom de l'application", "Version de l'application" et bien d'autres.
Mesurer les plantages et les exceptions
Le SDK Google Analytics pour Android introduit la mesure des exceptions et le type d'appel d'exception. La mesure des exceptions vous permet de mesurer le nombre et le type de plantages et d'exceptions non fatales. Pour savoir comment mettre en œuvre la mesure des exceptions, consultez le guide du développeur relatif aux exceptions.
Dimensions et métriques personnalisées
Créez des dimensions personnalisées pour segmenter vos données de façon inédite. En savoir plus sur les dimensions et métriques personnalisées
Mesurer les interactions sur les réseaux sociaux
Découvrez les avantages des réseaux sociaux dans votre application en mesurant les interactions des utilisateurs avec les widgets et les plug-ins intégrés. En savoir plus sur la mesure des interactions sur les réseaux sociaux

Avant de commencer

Tous les développeurs doivent suivre ces deux étapes avant de commencer la migration:

  1. Télécharger le SDK Google Analytics pour Android v2
  2. Créez une vue d'application (profil) que vous utiliserez pour accéder à vos nouveaux rapports et données.

Une fois que vous avez terminé les étapes ci-dessus, suivez la procédure de migration ci-dessous.

Migrer depuis EasyTracker

Pour migrer votre application de la version 1 à la version 2 de la bibliothèque EasyTracker, vous devez suivre trois étapes:

  1. Mettre à jour les paramètres dans votre fichier de ressources GoogleAnalytics.xml
  2. Mettre à jour les noms des méthodes
  3. Mettre à jour le récepteur de la diffusion (suivi des campagnes Google Play)

1. Mettre à jour les paramètres dans GoogleAnalytics.xml

Lors de la migration vers la version 2, mettez à jour les paramètres dans votre fichier de ressources GoogleAnalytics.xml, car certains d'entre eux ont changé depuis la version 1.x et de nouveaux paramètres ont été ajoutés dans la version 2.

Le tableau ci-dessous présente les paramètres mis à jour dans la version 2:

Nom du paramètre v1.xNom du paramètre v2.x
clé_api_gaID_suivi_ga
ga_auto_activity_tracking (suivi de l'activité automatique)ga_autoActivityTracking
ga_dryRunobsolète

Pour en savoir plus, consultez les paramètres nouveaux et mis à jour dans EasyTracker.

2. Mettre à jour les noms des méthodes

Bien qu'une grande partie de la syntaxe reste identique dans la version 2 d' EasyTracker, il existe des différences notables au niveau des noms de méthode et de la syntaxe. Vous devrez donc mettre à jour votre implémentation:

3. Mettre à jour le récepteur de diffusion (suivi des campagnes Google Play)

Les développeurs qui avaient implémenté le suivi des campagnes Google Play avec la version 1.x doivent noter que le chemin d'accès aux classes du destinataire a changé. Pour en savoir plus, consultez le Guide de suivi des campagnes Google Play.

Migrer à partir d'une implémentation personnalisée

Si vous n'utilisiez pas la bibliothèque EasyTracker dans la version 1.x du SDK Analytics pour Android, nous vous recommandons de commencer à utiliser EasyTracker dans la version 2.

La bibliothèque EasyTracker est désormais incluse dans le SDK et est recommandée pour tous les développeurs. Premiers pas avec EasyTracker dans la version 2 du SDK Google Analytics

Si vous avez des besoins avancés en termes de collecte de données, tels que l'utilisation de plusieurs ID de propriété dans une seule implémentation, consultez le guide de configuration avancée pour en savoir plus sur l'utilisation des fonctionnalités avancées de la version 2.x du SDK.