Indicateurs d’écran et d’application

  • iOS
  • watchOS
  • tvOS
 

Avant-propos

Les indicateurs d’application permettent d’associer des informations à l’activité de l’utilisateur pendant l’utilisation de son application.

Les indicateurs d’écran se focalisent sur une vue en particulier, et permettent notamment de marquer les champs d’un formulaire de saisie.

 

Pour bien débuter

Une fois votre marqueur initialisé, vous pouvez ajouter vos indicateurs à votre hit d’écran.

Dans le cas d’un projet Swift, veillez à importer le module SmartTracker (ou tvOSTracker/watchOSTracker si votre target est une Apple TV ou une Apple Watch) dans votre ViewController. Dans le cas d’un projet Objective-C pensez à inclure SmartTracker-Swift.h ou Tracker-Swift.h.

 

Marquage

L’objet Screen du tracker met à disposition un objet de type CustomVars qui expose une méthode add. Cette méthode accepte trois paramètres :

  • varId : indice de l’indicateur
  • value : valeur de l’indicateur, chaîne de caractères au format :
    • texte : [lorem]
    • décimal : séparateur « , » ou « . », deux caractères maximum après le séparateur
    • date : aaaammjj
    • pays : ISO
    • durée : entier
  • type : type de l’indicateur
 

Exemples de marquage

  1. Indicateur de site, avec une valeur date

    import UIKit
    import Tracker
    
    class ViewController: UIViewController {
        let tracker = ATInternet.sharedInstance.defaultTracker
        
        override func viewDidLoad() {
            super.viewDidLoad()
        }
        
        override func viewWillAppear(_ animated: Bool) {
            let screen = tracker.screens.add("My Screen with Custom Var")
            let _ = screen.customVars.add(1, value: "20141224", type: CustomVar.CustomVarType.app)
            screen.sendView()
        }
    }
    #import "SmartTracker/SmartTracker-Swift.h"
    
    @interface ViewController ()
    @property (nonatomic, strong) Tracker *tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
    }
    
    - (void)viewWillAppear:(BOOL)animated {
        [super viewWillAppear:animated];
        
        Screen *screen = [[self.tracker screens ] add:@"My Screen With Custom Var"];
        [screen.customVars add:1 value:@"20141224" type:CustomVarTypeApp];
        [screen sendView];
    }
    
    @end
  2. Indicateur d’écran avec une valeur texte

    import UIKit
    import Tracker
    
    class ViewController: UIViewController {
        let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
        
        override func viewDidLoad() {
            super.viewDidLoad()
        }
        
        override func viewWillAppear(_ animated: Bool) {
            let screen = tracker.screens.add("My Screen With Custom Var")
            let _ = screen.customVars.add(1, value: "[object]", type: CustomVar.CustomVarType.screen)
            screen.sendView()
        }
    }
    #import "SmartTracker/SmartTracker-Swift.h"
    
    @interface ViewController ()
    @property (nonatomic, strong) Tracker *tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
    }
    
    - (void)viewWillAppear:(BOOL)animated {
        [super viewWillAppear:animated];
        
        Screen *screen = [[[self.tracker] screens] add:@"My screen with custom var"];
        [screen.customVars add:1 value:@"[objet]" type:CustomVarTypeScreen];
        [screen sendView];
    }
    
    @end
 

Classe CustomVar

 

Propriétés

NomTypeValeur par défautDescription
varIdInt1Obtient ou définit l’identifiant de la variable
typeEnumCustomVarType.appObtient ou définit le type de la variable
valueStringChaîne videObtient ou définit la valeur de la variable
Dernière mise à jour : 13/12/2016