Developers » AS2 tagging » Android » Bien commencer » Initialisation du tracker 2.3.5
Initialisation du tracker
Pour bien débuter
Une fois la bibliothèque intégrée à votre projet, vous devez initialiser votre tracker pour pouvoir marquer vos différentes vues ou actions. La classe ATInternet vous permet d’initialiser un ou plusieurs trackers, de les nommer et de les garder en mémoire.
Prérequis
Afin de pouvoir utiliser le SDK AT Internet, il est INDISPENSABLE dajouter les autorisations suivantes dans votre fichier AndroidManifest juste avant la balise <application> :
<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
Initialisation
Une fois la bibliothèque AT Internet intégrée à votre projet, vous devez initialiser votre tracker pour pouvoir marquer vos différentes vues ou actions.
La classe ATInternet vous permet d’initialiser un ou plusieurs trackers, de les nommer et de les garder en mémoire.
Utilisation d’un tracker unique dans une application multithread
Attention, une même instance de Tracker ne doit pas être partagée dans le cadre d’une programmation
concurrente multithread sous peine de provoquer un crash de l’application. Le code du SDK n’étant pas thread-safe, il est nécessaire d’utiliser une instance différente de Tracker par thread.
Utilisation d’un tracker unique pour votre application
Si votre application ne nécessite pas lutilisation de plusieurs trackers, la classe ATInternet expose une méthode defaultTracker vous permettant de gérer facilement un tracker.
L’initialisation du Tracker doit être faite après la ligne
super.onCreate(savedInstanceState);
package com.atinternet.atinternetdemo; import android.app.Activity; import android.os.Bundle; import com.atinternet.tracker.ATInternet; import com.atinternet.tracker.Tracker; public class MainActivity extends Activity { private Tracker tracker; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); tracker = ATInternet.getInstance().getDefaultTracker(); } }
Laccès à l’objet defaultTracker permet d’instancier un tracker nommé defaultTracker et de garder son instance en mémoire. Ainsi lorsque vous ferez appel à nouveau à cet objet, vous récupérerez la même instance.
Utilisation de plusieurs trackers
Si vous avez besoin de gérer plusieurs trackers, la classe ATInternet vous permet d’instancier, de nommer et de garder en mémoire ces différentes instances.
Pour initialiser vos différents trackers, ajouter le code suivant dans la méthode onCreate de votre Activity ou onCreateView de votre Fragment :
private Tracker tracker; private Tracker audioTracker; private Tracker cartTracker; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); tracker = ATInternet.getInstance().getDefaultTracker(); audioTracker = ATInternet.getInstance().getTracker("audioTracker"); cartTracker = ATInternet.getInstance().getTracker("cartTracker"); }
Dans lexemple ci-dessus, trois instances de trackers sont créées :
- defaultTracker : instance par défaut
- audioTracker : un tracker utilisé pour marquer vos flux audio
- cartTracker : un tracker utilisé pour marquer votre panier de produits
Lors de lappel de ces mêmes objets / méthodes (e.g. dans une Activity), vous récupérez ces instances créées précédemment.
Dernière mise à jour : 26/02/2019