Screens

Get off to a good start

Once your tag is initialised, you can start tagging your screens.

In the case of a Swift project, be sure to import the Tracker (or TrackerExtension if your target is an extension) module in your ViewController. In the case of an Objective-C project, be sure to import the headers Tracker-Swift.h

Declare a Tracker variable in your ViewController

import UIKit
import Tracker

class ViewController: UIViewController {
    let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
    
    override func viewDidLoad() {
        super.viewDidLoad()
    }
    
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
}

#import "Tracker/Tracker-Swift.h"

@interface ViewController ()
@property (nonatomic, strong) Tracker *tracker;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.tracker = [ATInternet sharedInstance].defaultTracker;
}

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}

@end

Tagging

To tag a screen, the tracker exposes a screens property.

Two solutions are available to tag a screen:

• Define one or several tagging and send the hit(s) at the desired moment
• Send screen tagging directly

To do this, the screens property of the Tracker class offers an add method.
This method enables the addition of screen tagging which can be sent at the desired moment (e.g. viewDidLoad, viewWillAppear …).

The add method sends back a Screen-type object. To send the defined information, you must manually call the sendView method of your Screen method, or call the Tracker’s dispatch method.

Tagging examples

1. Tagging a screen:
   
   • Swift
   • Objective-C

   override func viewWillAppear(_ animated: Bool) {
       tracker.screens.add("Home").sendView()
   }

   - (void)viewWillAppear:(BOOL)animated {
       [[self.tracker.screens addWithName:@"Home"] sendView];
   }
2. Tagging a screen with a level 2:
   
   • Swift
   • Objective-C

   override func viewWillAppear(_ animated: Bool) {
       let myHomeScreen = tracker.screens.add("Home")
       myHomeScreen.level2 = 1 // Set a level 2 ID for myHomeScreen
       myHomeScreen.sendView()
   }

   - (void)viewWillAppear:(BOOL)animated {
       Screen *myHomeScreen = [tracker.screens add:@"Home"];
       myHomeScreen.level2 = 1; // Set a level 2 ID for myHomeScreen
       [myHomeScreen sendView];
   }
3. Tagging a screen with chapters:
   
   • Swift
   • Objective-C

   override func viewWillAppear(_ animated: Bool) {
       tracker.screens.add("Today News", chapter1: "Home", chapter2: "News").sendView()
   }

   - (void)viewWillAppear:(BOOL)animated {
      [[self.tracker.screens add:@"Today News" chapter1:@"Home" chapter2:@"News"] sendView];
   }
4. Tagging a screen with the addition of a custom object:
   
   • Swift
   • Objective-C

   override func viewWillAppear(_ animated: Bool) {
       let screen = tracker.screens.add()
       screen.customObjects.add(["lng": "fr"])
       screen.sendView()
   }

   - (void)viewWillAppear:(BOOL)animated {
       Screen *screen = [[tracker screens] add];
       [screen.customObjects addDictionary:@{@"lng":@"fr"}];
       [screen sendView];
   }
5. Tagging a screen with use of dispatcher:
   
   • Swift

   override func viewWillAppear(_ animated: Bool) {
       let screen = tracker.screens.add()
       screen.customVars.add(1, value: "fr", type: CustomVar.CustomVarType.Screen)
       screen.sendView()
   }

   - (void)viewWillAppear:(BOOL)animated {
       Screen *screen = [[tracker screens] add];
       [screen.customVars add:1 value:@"fr" type:CustomVarTypeScreen];
       [self.tracker dispatch];
   }
6. Tagging a screen with a name defined via a CustomObject (the name will be treated via DataManager)
   • Swift
   • Objective-C

   override func viewWillAppear(_ animated: Bool) {
       let screen = tracker.screens.add()
       screen.customObjects.add(["screenName": "Home"])
       screen.sendView()
   }

   - (void)viewWillAppear:(BOOL)animated {
       Screen *screen = [[tracker screens] add];
       [screen.customObjects addDictionary:@{@"screenName": @"Home"}];
       [[self.tracker.screens add] sendView];
   }
7. Tagging a basket :
   
   • Swift
   • Objective-C

   override func viewWillAppear(animated: Bool) {
       let screen = tracker.screens.add("Home")
       screen.cart = tracker.cart.set("myCart")
       screen.sendView()
   }

   - (void)viewWillAppear:(BOOL)animated {
       Screen *screenCart = [self.tracker.screens add:@"cart"];
       screenCart.cart = [self.tracker.cart set:@"mycart"];
       [screenCart sendView];
   }