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 d’ajouter 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 l’utilisation 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();
    }
}

L’accè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 l’exemple ci-dessus, trois instances de trackers sont créées :

1. defaultTracker : instance par défaut
2. audioTracker : un tracker utilisé pour marquer vos flux audio
3. cartTracker : un tracker utilisé pour marquer votre panier de produits

Lors de l’appel de ces mêmes objets / méthodes (e.g. dans une Activity), vous récupérez ces instances créées précédemment.