Ce guide de migration décrit les nouveautés de la version 2 du SDK et fournit aux développeurs des conseils pour migrer depuis une implémentation v1.x. Les développeurs qui n'ont pas besoin de migrer depuis une implémentation v1.x peuvent commencer à utiliser la version 2 dès maintenant.
Présentation
Google Analytics a récemment publié la version 2 du SDK Google Analytics pour Android mis à jour. La version 2 du SDK est compatible avec de nouvelles fonctionnalités et comprend une nouvelle interface de création de rapports conçue spécifiquement pour les développeurs d'applications.
Nous recommandons à tous les développeurs Google Analytics existants de passer à 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 offre une nouvelle expérience de reporting conçue pour les développeurs d'applications, de nouvelles dimensions et métriques puissantes, et bien plus encore. Voici les avantages de la version 2 pour les développeurs:
- Des rapports plus complets pour les développeurs d'applications
- Les rapports standards ont été repensés pour les développeurs d'applications et y ont ajouté de nouveaux rapports tels que le flux d'engagement et les sources Google Play, afin d'aider les développeurs à obtenir de nouvelles informations sur l'acquisition et l'expérience des utilisateurs. Consultez nos bonnes pratiques pour la configuration de compte afin d'en savoir plus sur la meilleure façon de configurer votre propriété pour la version 2.
- Nouvelles dimensions et métriques pour les applications
- De nouvelles dimensions et métriques propres aux applications ont été introduites dans la version 2 du SDK, y compris "Nom de l'écran" et "Vues de l'écran", "Nom de l'application", "Version de l'application", etc.
- Mesurer les plantages et les exceptions
- Le SDK Google Analytics pour Android introduit la mesure des exceptions et le type d'appel "Exception". La mesure des exceptions vous permet de mesurer le nombre et le type de plantages et d'exceptions non fatales. Pour découvrir comment implémenter la mesure des exceptions, consultez le guide du développeur sur les exceptions.
- Dimensions et métriques personnalisées
- Créez des dimensions personnalisées afin de segmenter vos données selon de nouvelles façons. En savoir plus sur les dimensions et métriques personnalisées
- Mesurer les interactions sur les réseaux sociaux
- Découvrez la valeur des réseaux sociaux dans votre application en mesurant les interactions des utilisateurs avec les widgets et plug-ins de réseaux sociaux intégrés. En savoir plus sur la mesure des interactions avec les réseaux sociaux
Avant de commencer
Avant de commencer la migration, tous les développeurs doivent effectuer ces deux étapes:
- Télécharger le SDK Google Analytics pour Android v2
- Créez une vue (profil) que vous utiliserez pour accéder aux nouveaux rapports et données de votre application.
Une fois que vous avez terminé les étapes ci-dessus, suivez les étapes ci-dessous pour votre chemin de migration.
Migrer depuis EasyTracker
Pour migrer votre application de la version 1 à la version 2 de la bibliothèque EasyTracker, vous devez suivre trois étapes:
- Mettre à jour les paramètres dans votre fichier de ressources GoogleAnalytics.xml
- Mettre à jour les noms des méthodes
- Mettre à jour votre broadcast receiver (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 qui ont été mis à jour dans la version 2:
| Nom du paramètre v1.x | Nom du paramètre v2.x |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | obsolète |
Pour en savoir plus, consultez les nouveaux paramètres EasyTracker mis à jour.
2. Mettre à jour les noms des méthodes
Bien qu'une grande partie de la syntaxe reste la même dans la version 2 d'EasyTracker, il existe des différences notables au niveau des noms et de la syntaxe des méthodes. Vous devrez donc mettre à jour votre implémentation:
trackPageView()estsendView()dans la version 2. Pour en savoir plus, consultez le Guide du développeur sur le suivi des écrans.- L'implémentation de l'e-commerce a été simplifiée. Découvrez comment implémenter la mesure de l'e-commerce dans la version 2.
- Les variables personnalisées ont été remplacées par les dimensions et métriques personnalisées. Tous les appels à
setCustomVar()doivent être mis à jour pour bénéficier de la nouvelle fonctionnalité. Découvrez comment implémenter des dimensions et des métriques personnalisées.
3. Mettre à jour le broadcast receiver (suivi des campagnes Google Play)
Les développeurs qui ont implémenté le suivi des campagnes Google Play avec la version 1.x doivent noter que le chemin d'accès aux classes du récepteur a été modifié. Pour en savoir plus, consultez le Guide de suivi des campagnes Google Play.
Migrer depuis 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 à l'utiliser à partir de 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 matière 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.