Operating principle

General principles

The AT Internet tag allows you to follow your users’ activity throughout your application’s lifecycle.

To help you, the tag makes available classes (helpers) enabling the quick implementation of tracking for different application events (screen loads, gestures, video plays…).

These helpers enable you to define or add different types of tagging and put them in a queue. This queue can be “emptied” by calling the dispatch method, available in the Tracker class: Dispatch()

The tracker is not compatible for use with competing accesses (thread-safety)

List of available classes

Advanced tagging

Aside from using helpers, it is also possible to “manually” tag your application via the setParam method of the Tracker.

The setParam method allows you to add a parameter that will be sent on the next hit or on all following hits (volatile or persistent).

This method can take as a parameter the object ParamOption allowing for definition of the following information:

• relativePosition: Parameter’s position in the hit with regards to another parameter
• relativeParameterKey: Relative parameter key
• append: Allows concatenation of several values in the same variable
• separator: In the case of a table-type variable, defines the separator shown in the URL. When the append option is used, the separator will be used to separate the concatenated values.
• encode: Allows encoding of the variable’s value (true by default)
• persistent: Indicates if the variable must be present in all hits, or only in the following hit..

In order to send the defined variables, you must then call the Tracker‘s dispatch method.

Advanced tagging example

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

   override func viewWillAppear(_ animated: Bool) {
       let s2ParamOption = ParamOption()
           s2ParamOption.persistent = true // Level 2 ID will be repeated on all hits
           
       let _ = ATInternet.sharedInstance.defaultTracker
           .setParam("s2", value: 1, options: s2ParamOption)
           .setParam("p", value: "Home") // Set screen name
           .dispatch() // send hit
   }

   - (void)viewWillAppear:(BOOL)animated {
       // Set screen name
       [[[ATInternet sharedInstance] defaultTracker] setStringParam:@"p" value:@"Home"];
       
       // Set level 2 ID for screen
       ParamOption *s2ParamOption = [[ParamOption alloc] init];
       s2ParamOption.persistent = YES; // Level 2 ID will be repeated on all hits
       
       [[[ATInternet sharedInstance] defaultTracker] setIntParam:@"s2" value:1 options:s2ParamOption];
       
       // Send hit
       [[[ATInternet sharedInstance] defaultTracker] dispatch];
   }
2. Sending a hit with a custom object:
   

   The hit will be considered as screen tagging

   • Swift
   • Objective-C

   override func viewWillAppear(_ animated: Bool) {
       ATInternet.sharedInstance.defaultTracker.setParam("stc", value: ["myCustomObject" : ["myLanguage": "fr", "myDevice": "iPad"]])
       ATInternet.sharedInstance.defaultTracker.dispatch()
   }

   - (void)viewWillAppear:(BOOL)animated {    
       // Set a custom object
       [[[ATInternet sharedInstance] defaultTracker] setDictionaryParam:@"stc" value:@{@"myCustomObject":@{@"myLanguage":@"fr",@"myDevice":@"iPad"}}];
       
       // Send hit
       [[[ATInternet sharedInstance] defaultTracker] dispatch];
   }

Default variables

When a hit is sent, the AT Internet tracker will automatically add variables to feed basic analyses: