Ce document explique comment utiliser le SDK Google Analytics pour Android v3.
Avant de commencer
Avant d'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 v3 (avec
libGoogleAnalyticsServices.jar
inclus dans le répertoire et le chemin de compilation/libs
de votre projet) - Vous disposez d'une application Android permettant d'implémenter Google Analytics.
- Au moins une propriété Google Analytics et une vue d'application (profil) vers lesquelles envoyer des données depuis votre application
Getting Started
La prise en main du SDK se fait en trois étapes:
Une fois ces étapes terminées, vous pourrez 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 chacun de vos Activities
, comme dans l'exemple suivant:
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. Créer le fichier analytics.xml
Lorsque vous utilisez EasyTracker, les paramètres de configuration généraux sont gérés à l'aide de ressources définies en XML. Créez un fichier nommé analytics.xml
dans le répertoire res/values
de votre projet et ajoutez les ressources suivantes:
<?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 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 pour obtenir la liste complète des paramètres que vous pouvez utiliser pour configurer votre mise en œuvre. En fonction des exigences de votre application, vous pouvez modifier la période d'envoi pour vérifier que vous envoyez correctement les appels. Par exemple, si vous souhaitez afficher des données en temps réel, vous pouvez définir une valeur faible, telle que 5 s.
Félicitations ! Votre application est maintenant configurée pour envoyer des données à Google Analytics.
Étapes suivantes
Google Analytics vous offre bien plus de possibilités, y compris la mesure des campagnes, des transactions et des paiements via l'application, ainsi que des événements d'interaction utilisateur.
Les guides du développeur suivants fournissent des informations supplémentaires sur la façon d'implémenter les fonctionnalités Google Analytics dans votre 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 contenus multimédias à l'aide des événements.
- Mesurer les paiements via l'application : découvrez comment mesurer les paiements et les transactions via l'application.
- Mesurer les campagnes : découvrez comment implémenter la mesure des campagnes afin d'identifier les canaux et les campagnes qui génèrent des installations d'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.
- Configuration avancée – Apprenez-en plus sur les options de configuration avancées, y compris l'utilisation de plusieurs outils de suivi.
-
Paramètres Analytics.xml : consultez la liste complète des paramètres de configuration
analytics.xml
.