Le SDK Google Analytics pour Android permet aux développeurs de collecter facilement des données sur l'engagement utilisateur à partir de leurs applications. Ce document présente les avantages du SDK, ainsi qu'un guide pour commencer à mesurer votre application à l'aide d'un seul ID de propriété et d'EasyTracker.
Présentation
Le SDK Google Analytics pour Android permet aux développeurs de collecter facilement des données sur l'engagement utilisateur à partir de leurs applications. Les développeurs peuvent ensuite utiliser les rapports Google Analytics pour mesurer:
- Nombre d'utilisateurs actifs qui utilisent leurs applications.
- L'endroit dans le monde où l'application est utilisée.
- Adoption et utilisation de fonctionnalités spécifiques.
- Achats et transactions via une application
- Nombre et type de plantages de l'application.
- Et bien d'autres métriques utiles.
De plus, le SDK Google Analytics pour Android vous fournit les outils nécessaires pour surveiller l'efficacité de vos campagnes marketing sur mobile. Il offre une visibilité de bout en bout sur les performances de vos canaux marketing, des installations Google Play aux achats via les applications et aux transactions.
Avant de commencer
Avant de commencer à implémenter le SDK, assurez-vous de disposer des éléments suivants:
- SDK pour les développeurs Android (disponible pour Windows, Mac OS X et Linux)
- SDK Google Analytics pour Android v2 (avec
libGoogleAnalyticsV2.jar
inclus dans le répertoire et le chemin de compilation/libs
de votre projet) - Une application Android que vous pouvez utiliser afin d'implémenter le SDK Google Analytics pour Android v2
- Une nouvelle propriété d'application et vue (profil) Google Analytics.
Premiers pas
Pour commencer à utiliser le SDK, vous devez suivre trois étapes:
Une fois ces étapes terminées, vous pouvez mesurer les éléments suivants avec Google Analytics:
- Installations d'applications
- Utilisateurs actifs et données démographiques
- Écrans et engagement utilisateur
- Plantages et exceptions
1. Mise à jour du fichier AndroidManifest.xml
Mettez à jour votre fichier AndroidManifest.xml en ajoutant les autorisations suivantes:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. Ajouter des méthodes EasyTracker
Ajoutez les méthodes d'envoi aux méthodes onStart()
et onStop()
de chacune de vos Activities
, comme dans l'exemple suivant:
/** * 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. } }
Notez qu'EasyTracker nécessite l'autorisation Context
pour que vous puissiez appeler ses méthodes. Dans l'exemple ci-dessus, cette ligne:
EasyTracker.getInstance.activityStart(this);
s'occupe de définir le contexte. Toutefois, si vous devez effectuer des appels EasyTracker dans d'autres classes ou méthodes, vous devez d'abord appeler la méthode setContext(Context ctx)
d'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. Créer votre fichier analytics.xml
Dans la version 2 du SDK Google Analytics pour Android, les options de configuration sont gérées à partir d'un fichier de ressources XML, appelé analytics.xml
dans ce guide. Vous devez créer ce fichier dans le répertoire res/values
de votre projet et ajouter votre ID de suivi. L'exemple suivant montre comment ajouter votre ID de suivi, et activer la mesure de Activity
et des exceptions:
<?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>
L'outil de vérification lint peut vous avertir de l'utilisation du tiret (-) dans votre ID de suivi. Vous pouvez supprimer cet avertissement en ajoutant des attributs supplémentaires à votre balise <resources>
:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
Consultez la documentation de référence sur les paramètres analytics.xml afin d'obtenir la liste complète des paramètres que vous pouvez utiliser pour configurer votre mise en œuvre.
Félicitations ! Votre application est maintenant configurée pour envoyer des données à Google Analytics.
Étapes suivantes
Google Analytics offre bien d'autres possibilités, y compris la mesure des campagnes, des transactions et des paiements via les applications, ainsi que des événements d'interaction utilisateur. Consultez les guides du développeur suivants pour découvrir comment ajouter ces fonctionnalités à votre implémentation:
- Configuration avancée : découvrez les options de configuration avancées, y compris l'utilisation de plusieurs outils de suivi.
- Mesurer les campagnes : découvrez comment mesurer les performances des campagnes afin d'identifier les canaux et les campagnes qui génèrent des installations d'application.
- Mesurer les événements : découvrez comment mesurer l'engagement des utilisateurs avec des contenus interactifs comme des boutons, des vidéos et d'autres médias grâce aux événements.
- Mesurer les paiements via l'application : découvrez comment mesurer les paiements et les transactions via l'application.
- Temps utilisateur : découvrez comment mesurer les temps utilisateur dans votre application afin de mesurer les temps de chargement, l'engagement avec les médias, etc.
- Paramètres Analytics.xml : consultez la liste complète des paramètres de configuration
analytics.xml
.