Track
Track Views
Track screen views with the trackViewWithTitle()
method. This is done in the viewDidAppear()
method of any View Controller. This method accepts two parameters: the name of the screen and (optionally) contextual view data.
The screen name value is set in the event attribute screen_title
.
// Retrieve instance
let tealium = Tealium.instance(forKey: "INSTANCE")
// Basic
tealium?.trackViewWithTitle("SCREEN_NAME", dataSources: nil)
// With optional data
let optionalData = ["KEY1": "VALUE1"]
tealium?.trackView(withTitle: "SCREEN_NAME", dataSources: optionalData)
// With optional array data
let optionalData = ["KEY1": ["STRING1", "STRING2"]]
tealium?.trackView(withTitle: "SCREEN_NAME", dataSources: optionalData)
// Retrieve instance
Tealium *tealium = [Tealium instanceForKey:@"INSTANCE"];
// Basic
[tealium trackViewWithTitle:@"SCREEN_NAME" dataSources:nil];
// With optional data
NSDictionary *optionalData = @{@"KEY1" : @"VALUE1"};
[tealium trackViewWithTitle:@"SCREEN_NAME" dataSources: optionalData];
// With optional array data
NSDictionary *optionalData = @{@"KEY1" : @[@"STRING1", "STRING2"]};
[tealium trackViewWithTitle:@"SCREEN_NAME" dataSources: optionalData];
Parameter | Type | Description | Swift Example | iOS Example |
---|---|---|---|---|
title |
String |
Title of view | "screenName" |
"screenName" |
customDataSources |
[String] |
(Optional) Custom datasources (key-value pairs) to be included in the event dispatch | @{@"someKey": @"someValue"} |
["someKey": "someValue"] |
Track Events
Track non-view activity with the trackEventWithTitle()
method. This method accepts two parameters: an event name and (optionally) contextual event data.
The event name value is populated in the event attribute named tealium_event
.
// Retrieve instance
let tealium = Tealium.instance(forKey: "INSTANCE")
// Basic
tealium?.trackEvent(withTitle: "EVENT_NAME", dataSources: nil)
// With optional data
let optionalData = ["KEY1": "VALUE1"]
tealium?.trackEvent(withTitle: "EVENT_NAME", dataSources: optionalData)
// With optional array data
let optionalData = ["KEY1": ["STRING1", "STRING2"]]
tealium?.trackEvent(withTitle: "EVENT_NAME", dataSources: optionalData)
// Retrieve instance
Tealium *tealium = [Tealium instanceForKey:@"INSTANCE"];
// Basic
[tealium trackEventWithTitle:@"EVENT_NAME" dataSources:nil];
// With optional data
NSDictionary *optionalData = @{@"KEY1" : @"VALUE1"};
[tealium trackEventWithTitle:@"EVENT_NAME" dataSources:optionalData];
// With optional array data
NSDictionary *optionalData = @{@"KEY1" : @[@"STRING1", @"STRING2"]};
[tealium trackEventWithTitle:@"EVENT_NAME" dataSources:optionalData];
Parameter | Type | Description | Swift Example | iOS Example |
---|---|---|---|---|
title |
String |
Title of event | "someEvent" |
"someEvent" |
customDataSources |
[String] |
(Optional) Custom datasources (key-value pairs) to be included in the event dispatch | @{@"someKey": @"someValue"} |
["someKey": "someValue"] |