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