Track

Track Views

To track screen views, pass an instance of TealiumView(viewName:dataLayer:) to the track() method. TealiumView is comprised of a view name, which appears in the data layer as tealium_event, and an optional data dictionary.

The following is an example:

let tealView = TealiumView("VIEW_NAME", dataLayer: ["key": "value"])
tealium?.track(tealView)

Track Events

To track non-view events, pass an instance of TealiumEvent(eventName:dataLayer:) to the track() method. TealiumEvent is comprised of an event name, which appears in the data layer as tealium_event, and an optional data dictionary.

The following is an example:

let tealEvent = TealiumEvent("EVENT_NAME", dataLayer: ["key": "value"])
tealium?.track(tealEvent)

Trace

Join Trace

The joinTrace() method joins a trace with the specified ID. Learn more about the Trace feature in the Tealium Customer Data Hub.

class TealiumHelper {
	var tealium: Tealium?
	// ...

	func joinTrace(traceId id: String) {
		tealium?.joinTrace(id: "TRACE_ID")
		// ...
	}
}

Leave trace

A trace remains active for the duration of the app session until the leaveTrace() method is called, which leaves a previously joined trace and ends the visitor session.

class TealiumHelper {
	var tealium: Tealium?
	// ...

	func leaveTrace() {
		tealium?.leaveTrace()
		// ...
	}
}

Connector actions set to run at "End of Visit" do not run until the session expires.

To preserve the trace visitor session when leaving the trace, pass the optional argument false, as shown in the following example:

tealium?.leaveTrace(killVisitorSession: false)