Visiteurs identifiés

  • iOS
  • watchOS
  • tvOS
 

Avant-propos

Les visiteurs identifiés sont les visiteurs que vous êtes capables de reconnaître suite à une authentification (inscription, abonnement, login…). Ces visiteurs peuvent être regroupés en catégories afin d’obtenir une vision plus globale dans vos analyses.

Un visiteur peut être identifié avec un un identifiant numérique ou textuel.

Si différentes valeurs sont rencontrées au cours de la même visite, seule la première sera prise en compte.

 

Pour bien débuter

Une fois votre marqueur initialisé, vous pouvez ajouter les informations d’identification du visiteur.

Dans le cas d’un projet Swift, veillez à importer le module SmartTracker (ou TrackerExtension si votre target est une extension) dans votre ViewController. Dans le cas d’un projet objective-c, vous devrez importer « SmartTracker/SmartTracker-Swift.h ».

 

Marquage

Le tracker possède une propriété identifiedVisitor. Cette propriété offre un ensemble de méthodes pour activer ou désactiver l’identification du visiteur. Ce type de marquage est persistant par défaut, c’est-à-dire que même si l’application est quittée, les données d’identification du visiteur seront présentes dans les hits une fois l’application relancée. En mode « non persistant », les données seront automatiquement effacées une fois l’application quittée. Il est également possible de supprimer les données d’identification manuellement.

 

Exemples de marquage

  1. Marquage d’un écran avec un identifiant numérique de visiteur

    let tracker = ATInternet.sharedInstance.defaultTracker
    
    override func viewWillAppear(animated: Bool) {
        _ = tracker.identifiedVisitor.set(123456)
        tracker.screens.add("MyAccount").sendView()
    }
    @interface ViewController ()
    @property (nonatomic, strong) Tracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
    }
    
    - (void)viewWillAppear:(BOOL)animated {
        [super viewWillAppear:animated];
        
        [self.tracker.identifiedVisitor setInt:123456];
        [[self.tracker.screens add:@"MyAccount"] sendView];
    }
    
    @end
  2. Marquage d’un écran avec un identifiant numérique et une catégorie

    let tracker = ATInternet.sharedInstance.defaultTracker
    
    override func viewWillAppear(animated: Bool) {
        _ = tracker.identifiedVisitor.set(123456, visitorCategory: 101)
        tracker.screens.add("MyAccount").sendView()
    }
    @interface ViewController ()
    @property (nonatomic, strong) Tracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
    }
    
    - (void)viewWillAppear:(BOOL)animated {
        [super viewWillAppear:animated];
        
        [self.tracker.identifiedVisitor set:123456 :101];
        [[self.tracker.screens addWithName:@"MyAccount"] sendView];
    }
    
    @end
  3. Marquage d’un écran avec ajout d’un identifiant textuel de visiteur

    let tracker = ATInternet.sharedInstance.defaultTracker
    
    override func viewDidAppear(animated: Bool) {
        _ = tracker.identifiedVisitor.set("user12345")
        tracker.screens.add("MyScreen").sendView()
    }
    @interface ViewController ()
    @property (nonatomic, strong) Tracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
    }
    
    - (void)viewWillAppear:(BOOL)animated {
        [super viewWillAppear:animated];
        
        [self.tracker.identifiedVisitor setString:@"user12345"];
        [[self.tracker.screens addWithName:@"MyScreen"] sendView];
    }
    
    @end
  4. Marquage d’un écran avec ajout d’un identifiant textuel et d’une catégorie

    let tracker = ATInternet.sharedInstance.defaultTracker
    
    override func viewDidAppear(animated: Bool) {
        _ = tracker.identifiedVisitor.set("user12345", visitorCategory: 101)
        tracker.screens.add("MyScreen").sendView()
    }
    @interface ViewController ()
    @property (nonatomic, strong) ATTracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
    }
    
    - (void)viewWillAppear:(BOOL)animated {
        [super viewWillAppear:animated];
        
        [self.tracker.identifiedVisitor setString:@"user12345" :101];
        [[self.tracker.screens addWithName:@"MyScreen"] sendView];
    }
    
    @end
  5. Pour désactiver l’identification visiteur (e.g lors de la déconnexion de l’utilisateur)

    @IBAction func logOut(sender: UIButton) {
        ATInternet.sharedInstance.defaultTracker.identifiedVisitor.unset()
    }
    - (IBAction)logOut:(UIButton *)sender {
        [[ATInternet sharedInstance].defaultTracker.identifiedVisitor unset];
    }
  6. Désactivation du mode persistant

    let tracker = ATInternet.sharedInstance.defaultTracker
    
    override func viewDidLoad() {
        tracker.setConfig("persistIdentifiedVisitor", value: "false") { (isSet) -> Void in
            print("Visitor id won't be persisted anymore")
        }
    }
    @interface ViewController ()
    @property (nonatomic, strong) Tracker* tracker;
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.tracker = [ATInternet sharedInstance].defaultTracker;
        [self.tracker setConfig:@"persistIdentifiedVisitor" value:@"false" completionHandler:^(BOOL isSet) {
            NSLog(@"%@", @"Visitor id won't be persisted anymore");
        }];
    }
    
    @end