Level 2s

Foreword

AT Internet’s SDK offers you the possibility to “separate” your application into different sections (called “level 2s”). These level 2s allow you to better target certain parts of your application in order to zoom in on how these parts are used.

Get off to a good start

Once your tag is initialised, you can modify the level 2 ID used in the sending of hits.

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 or Tracker-Swift.h in case of a Cocoapods integration.

Tagging

The SDK allows you to modify the level 2 ID that will be sent during a screen hit, a gesture hit… You Can also modify the level 2 ID in a more “global” manner for permanent use.

The tracker possesses a context property which itself possesses a level2 subproperty. By default, this property is 0. By editing this property’s value, the level 2 ID will be added in to future hits.

To disable this feature, simply reset the ID to 0.

Tagging examples

In these examples, we’ll consider the addition of level 2 information on screen tagging.

1. Setup of a level 2 when a user enters a particular section of the app
   • Swift
   • Objective-C

   override func viewWillAppear(animated: Bool) {
       ATInternet.sharedInstance.defaultTracker.context.level2 = 1
       ATInternet.sharedInstance.defaultTracker.screens.add("home").sendView()
   }

   - (void)viewWillAppear:(BOOL)animated {
       [super viewWillAppear:animated];
       
       [ATInternet sharedInstance].defaultTracker.context.level2 = 1;
       [[[ATInternet sharedInstance].defaultTracker.screens add:@"home"] sendView];
   }
2. Delete tracker’s level 2 by default when screen is changed
   
   • Swift
   • Objective-C

   override func viewWillDisappear(animated: Bool) {
       ATInternet.sharedInstance.defaultTracker.context.level2 = 0
   }

   - (void)viewWillAppear:(BOOL)animated {
       [super viewWillAppear:animated];
       
       [ATInternet sharedInstance].defaultTracker.context.level2 = 0;
   }
3. Override a level 2 for a hit
   • Swift
   • Objective-C

   import UIKit
   import Tracker
   
   class ViewController: UIViewController {
       let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
       
       override func viewDidLoad() {
           super.viewDidLoad()
       }
       
       override func viewWillAppear(animated: Bool) {
           // Set level 2 ID for next hits
           tracker.context.level2 = 1
           tracker.screens.add("home").sendView()
       }
   
       @IBAction func touchButton(sender: UIButton) {
           let touch = tracker.gestures.add("ButtonTouch")
           touch.level2 = 2 // Override level 2 ID for this hit
           touch.sendTouch()
       }
       
       override func prepareForSegue(segue: UIStoryboardSegue, sender: AnyObject?) {
           // Level 2 ID will be equal to "1"
           tracker.gestures.add("Go to product detail").sendNavigation()
       }
   }

   #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)viewWillAppear:(BOOL)animated {
       [super viewWillAppear:animated];
       // Set level 2 ID for next hits
       self.tracker.context.level2 = 1;
       [[self.tracker.screens add:@"home"] sendView];
   }
   
   - (IBAction)touchButton:(UIButton *)sender {
       Gesture *touch = [self.tracker.gestures add:@"ButtonTouch"];
       touch.level2 = 2; // Override level 2 for this hit
       [touch sendTouch];
   }
   
   - (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {
       // Level 2 ID will be equal to "1"
       [[self.tracker.gestures add:@"Go to product detail"] sendNavigation];
   }
   
   @end