Apprendre à installer Piwik sur une application mobile Android
Avez-vous déjà essayé de mettre en place une solution de web analytics sur une application mobile ? Pas facile, hein ? C’est pourquoi nous avons décidé de vous rédiger un petit tutoriel sur ce sujet. Dans notre cas de figure, nous avons choisi d’installer Piwik sur une application Android.
Que permet de faire ce tutoriel ?
Ce tutoriel va vous permettre d’ajouter le tracking de base de Piwik sur une application mobile et de récupérer les données dans Piwik comme ce serait le cas pour un site internet. Notre exemple va permettre de remonter les visites et les visiteurs uniques.
Pour ce tutoriel, l’environnement utilisé est celui de Linux.
Prérequis pour l’installation
- Android Studio
- Piwik installé sur un serveur
1re étape de l’installation : ajouter le site dans Piwik
Allez dans « All Websites », puis, à la fin de la liste de sites, cliquez sur « Ajouter un site ». Si ce lien n’apparaît pas, c’est que vous n’êtes pas connecté en tant que « Super-Utilisateur ». Vous avez juste à entrer un nom et à valider ; l’important est de noter l’ID du site que nous allons utiliser plus tard.
Ici, par exemple, lorsque nous avons validé le nom, l’ID attribué a été le numéro 5 :
2e étape : la création de votre application Android
Pour commencer, vous allez créer un nouveau projet dans Android Studio avec une activité vide (Empty Activity).
Dans le menu de l’application, vous allez remarquer la présence de 2 parties : app et Gradle.
Dans Gradle, vous allez ouvrir le fichier build.gradle (Module : app) et ajouter la ligne de code ci-dessous dans dependencies (cela permet à votre application d’aller chercher les fichiers nécessaires pour faire tourner Piwik) :
compile 'org.piwik.sdk:piwik-sdk:2.0.0'
À noter qu’ici nous avons pris la version 2.0.0, la plus récente à la date de rédaction de cet article. Pour obtenir la version la plus récente : GitHub de Piwik Android.
3e étape : ajouter le code de suivi de Piwik dans l’application
Au niveau de votre activité (fichier MainActivity.java), il va vous falloir ajouter les lignes de code de suivi ci-dessous :
import org.piwik.sdk.Piwik; import org.piwik.sdk.Tracker; import org.piwik.sdk.TrackerConfig;
N’oubliez pas de synchroniser votre fichier Gradle pour éviter des erreurs, tout comme la mise à jour d’Android Studio.
Puis, dans la classe de ce même fichier :
private Tracker tracker;
public synchronized Tracker getTracker() {
if (tracker == null) tracker = Piwik.getInstance(this).newTracker(new TrackerConfig("http://mon.site.com/piwik.php", 2,"mobile"));
return tracker;
}
Il faut remplacer les arguments du TrackerConfig : le premier argument est le lien vers piwik.php, le deuxième est le numéro d’ID du site que vous avez préalablement ajouté dans votre Piwik lors de la première partie. Enfin, le dernier paramètre est simplement le nom que vous souhaitez donner à ce tracking.
Dans notre cas de figure, ce sera :
"https://piwik.ronan-chardonneau.fr/piwik.php", 5,"mobile"
Ensuite, dans la méthode onCreate de MainActivity, ajoutez après super :
tracker = getTracker();
TrackHelper.track().screen(/activity_main/activity_settings).title("Hello world").with(tracker);
Vous devriez au final aboutir à un fichier ressemblant à ceci :
Enfin, si vous testez (en cliquant sur Run App) ou si vous créez l’application via Build –> Build .apk et que vous l’installez, les données devraient normalement remonter dans Piwik. À noter qu’il y a un délai, généralement d’une bonne trentaine de minutes, avant que ces dernières ne remontent dans Piwik. À noter également que si vous avez déclenché un émulateur d’Android Studio, les données peuvent également remonter :
Il existe beaucoup de codes de suivi différents :
- Suivi d’un événement
- Suivi d’un objectif
- Envoi de variables personnalisées
- Tracking spécifique à l’e-commerce
Pour plus d’informations, nous vous invitons à vous rendre sur le GitHub du SDK de Piwik Android : https://github.com/piwik/piwik-sdk-android/wiki/Getting-started
Problèmes connus pour ce tutoriel :
si vous n’arrivez pas à compiler dans Android Studio, essayez de saisir dans le terminal (en bas de l’IDE) simplement gradlew. Si vous recevez une erreur indiquant que JAVA_HOME n’est pas présent, c’est qu’il faut l’ajouter dans les variables d’environnement de votre ordinateur.
