Principe de fonctionnement

  • iOS
  • watchOS
  • tvOS
 

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 : Dispatch()

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
PublisherClasse permettant le marquage de vos publicités
SelfPromotionClasse permettant le marquage de vos campagnes d’auto-promotion
CartClasse permettant le marquage de votre panier de produits (dans le cadre d’un marquage SalesTracker)
ProductClasse permettant le marquage de vos produits
OrderClasse permettant le marquage de vos commandes (dans le cadre d’un marquage SalesTracker)
CustomObjectClasse permettant l’ajout d’objets personnalisés sur vos hits
IdentifiedVisitorClasse permettant la gestion de l’identification de vos utilisateurs
NuggAdClasse permettant l’ajout d’information issue de notre partenaire NuggAd dans vos hits
MediaPlayerClasse permettant le marquage de vos flux audio et vidéo
 

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 func viewWillAppear(_ animated: Bool) {
        let s2ParamOption = ParamOption()
            s2ParamOption.persistent = true // Level 2 ID will be repeated on all hits
            
            let _ = ATInternet.sharedInstance.defaultTracker
                .setParam("s2", value: 1, options: s2ParamOption)
                .setParam("p", value: "Home") // Set screen name
                .dispatch() // send hit
    }
    - (void)viewWillAppear:(BOOL)animated {
        // Set screen name
        [[[ATInternet sharedInstance] defaultTracker] setStringParam:@"p" value:@"Home"];
        
        // Set level 2 ID for screen
        ParamOption *s2ParamOption = [[ParamOption alloc] init];
        s2ParamOption.persistent = YES; // Level 2 ID will be repeated on all hits
        
        [[[ATInternet sharedInstance] defaultTracker] setIntParam:@"s2" value:1 options:s2ParamOption];
        
        // Send hit
        [[[ATInternet sharedInstance] defaultTracker] dispatch];
    }
  2. Envoi d’un hit avec un objet personnalisé :

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

    override func viewWillAppear(_ animated: Bool) {
        let _ = ATInternet.sharedInstance.defaultTracker.setParam("stc", value: ["myCustomObject" : ["myLanguage": "fr", "myDevice": "iPad"]])
        ATInternet.sharedInstance.defaultTracker.dispatch()
    }
    - (void)viewWillAppear:(BOOL)animated {    
        // Set a custom object
        [[[ATInternet sharedInstance] defaultTracker] setDictionaryParam:@"stc" value:@{@"myCustomObject":@{@"myLanguage":@"fr",@"myDevice":@"iPad"}}];
        
        // Send hit
        [[[ATInternet sharedInstance] defaultTracker] 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 bundle 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
dlsSource du téléchargement du SDK
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
 

Cet article vous a-t-il été utile ?

Dernière mise à jour : 26/02/2019