Principe de fonctionnement

 

Principes généraux

Le marqueur AT Internet vous permet de suivre l’activité de vos utilisateurs tout au long du cycle de vie de votre application.

Afin de vous aider, ce dernier met à disposition des classes (dites helpers) permettant la mise en place rapide du suivi des différents évènements de votre application (chargement d’écrans, gestes, lecture de vidéos …).

Ces helpers vous permettent de définir ou d’ajouter différents types de marquage et de les mettre dans une file d’attente. Cette dernière pourra être « vidée » par l’appel de la méthode dispatch disponible dans la classe Tracker.

Le tracker n’est pas compatible pour une utilisation avec des accès concurrents (thread-safety)

 

Liste des classes disponibles

NomDescription
ScreenClasse permettant le marquage d’écrans
DynamicScreenClasse permettant le marquage d’écrans dont le nom peut varier (e.g : flux d’actualités)
GestureClasse permettant le marquage de gestes
Campaign (déprécié depuis 2.3.0, voir Ecrans)Classe permettant l’ajout d’information de campagnes sur vos hits d’écrans
PublisherClasse permettant le marquage de vos publicités
SelfPromotionClasse permettant le marquage de vos campagnes d’auto-promotion
Aisle (déprécié depuis 2.3.0, voir Ecrans)Classe permettant le marquage de vos rayons (dans le cadre d’un marquage SalesTracker)
CartClasse permettant le marquage de votre panier de produits (dans le cadre d’un marquage SalesTracker)
OrderClasse permettant le marquage de vos commandes (dans le cadre d’un marquage SalesTracker)
Location (déprécié depuis 2.3.0, voir Ecrans)Classe permettant l’ajout d’information de géolocalisation sur vos hits d’écrans
CustomObjectClasse permettant l’ajout d’objets personnalisés sur vos hits
CustomVar (déprécié depuis 2.3.0, voir Ecrans)Classe permettant l’ajout de variables personnalisées sur vos hits d’écrans
IdentifiedVisitorClasse permettant la gestion de l’identification de vos utilisateurs
InternalSearch (déprécié depuis 2.3.0, voir Ecrans et Gestes)Classe permettant le marquage de votre moteur de recherche interne
NuggAdClasse permettant l’ajout d’information issue de notre partenaire NuggAd dans vos hits
TVTrackingClasse permettant l’ajout d’information de TV Tracking dans vos hits
MediaPlayerClasse permettant le marquage de vos flux audio et vidéo
ProductClasse permettant le marquage de vos produits
CustomTreeStructure (déprécié depuis 2.3.0, voir Ecrans)Classe permettant le marquage de vos arborescences personnalisées
 

Marquage avancé

Outre l’utilisation des helpers, vous avez la possibilité de marquer « manuellement » votre application via la méthode setParam du Tracker.

La méthode setParam vous permet d’ajouter un paramètre qui sera envoyé sur le prochain hit ou sur tous les suivants (volatile ou persistant).

Cette méthode peut prendre en paramètre un objet ParamOption permettant de définir les informations suivantes :

  • relativePosition : Position du paramètre dans le hit par rapport à un autre paramètre
  • relativeParameterKey : Clé du paramètre relatif
  • append : Permet de concaténer plusieurs valeurs dans une même variable
  • separator : Dans le cas d’une variable de type tableau, définit le séparateur qui sera affiché dans l’URL. Dans le cas de l’utilisation de l’option append, le séparateur sera utilisé pour séparer les valeurs concaténées.
  • encode : Permet d’encoder la valeur de la variable (true par défaut)
  • persistent : Indique si la variable doit être présente dans tous les hits ou seulement dans le hit suivant.

Afin d’envoyer les variables définies, vous devez ensuite appeler la méthode dispatch du Tracker.

 

Exemple de marquage avancé

  1. Marquage d’un écran :
        @Override
        protected void onResume() {
            super.onResume();
            // Set screen name
            ATInternet.getInstance().getDefaultTracker().setParam("p", "Home");
    
            // Set level 2 ID for screen
            ParamOption s2ParamOption = new ParamOption().setPersistent(true);
            ATInternet.getInstance().getDefaultTracker().setParam("s2", 1, s2ParamOption);
    
            // Send hit
            ATInternet.getInstance().getDefaultTracker().dispatch();
        }
  2. Envoi d’un hit avec un objet personnalisé :

    Le hit sera considéré comme un marquage d’écran

        @Override
        protected void onResume() {
            super.onResume();
            HashMap<String, String> myCustomObject = new HashMap<String, String>();
            myCustomObject.put("myLanguage", "fr");
            myCustomObject.put("myDevice", "Samsung Galaxy S6");
    
            ATInternet.getInstance().getDefaultTracker().setParam("stc", myCustomObject).dispatch();
        }
 

Variables par défaut

Lors de l’envoi d’un hit, le tracker AT Internet va automatiquement ajouter des variables permettant d’alimenter les analyses de base :

NomDescription
vtagObtient la version du SDK
ptagObtient la plateforme où est intégré le SDK (e.g. : iOS, Android …)
lngObtient la langue de l’utilisateur
mfmdObtient la marque et le modèle de l’appareil
osObtient le nom et la version du système d’exploitation de l’appareil
apvrObtient la version de l’application
apidObtient le nom du package de l’application
hlObtient l’heure locale de l’appareil
rObtient la résolution de l’appareil
carObtient l’opérateur de l’appareil
cnObtient le type de connexion
tsObtient un timestamp indiquant l’heure de création du hit
idclientObtient l’identifiant de l’utilisateur
dg (>= 2.2.2)Obtient la diagonale de l’écran
stcObtient le JSON contenant les données de cycle de vie de l’application, les informations de crashs s’il y’a lieu, ou les objets personnalisés
Dernière mise à jour : 25/02/2019