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.

 

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
CampaignClasse 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
AisleClasse 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)
LocationClasse permettant l’ajout d’information de géolocalisation sur vos hits d’écrans
CustomObjectClasse permettant l’ajout d’objets personnalisés sur vos hits
CustomVarClasse permettant l’ajout de variables personnalisées sur vos hits d’écrans
IdentifiedVisitorClasse permettant la gestion de l’identification de vos utilisateurs
InternalSearchClasse permettant le marquage de votre moteur de recherche interne
MediaPlayerClasse permettant le marquage de vos flux audio et vidéo
ProductClasse permettant le marquage de vos produits
CustomTreeStructureClasse 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 :
    public MainPage () {
        this.InitializeComponent();
        // Set screen home
        SmartTag.Instance.defaultTracker.SetParam("p", "Home");
    
        // Set level 2 ID for screen
        ParamOption s2ParamOption = new ParamOption();
        s2ParamOption.Persistent = true;
        SmartTag.Instance.defaultTracker.SetParam("s2", 1, s2ParamOption);
    
        // Send hit
        SmartTag.Instance.defaultTracker.Dispatch();
    }
  2. Envoi d’un hit avec un objet personnalisé :

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

    public MainPage()
    {
        this.InitializeComponent();
        Dictionary<string, object> myCustomObject = new Dictionary<string, object>()
        {
            { "myLanguage" , "fr" },
            { "myDevice"   , "Lumia" }
        };
        SmartTag.Instance.defaultTracker.SetParam("stc", myCustomObject);
    }

     

 

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
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
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 : 26/01/2017