Track

Track Views

TealiumView(viewName:dataLayer:) tracks screen views with optional associated data. The value passed to viewName appears in the data layer as the variable tealium_event.

The following is an example:

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

The track() method tracks a screen view by accepting a TealiumDispatch of type TealiumView which is comprised of a screen/view name and an optional data dictionary.

Track Events

TealiumEvent(eventName:dataLayer:) tracks non-view events with optional associated data. The value passed to eventName appears in the data layer as the variable tealium_event.

The following is an example:

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

The track() method tracks an event by accepting a TealiumDispatch of type TealiumEvent, which is comprised of an event name and an optional data dictionary.

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)