Track

Track Views

The trackView() method tracks a screen view with associated data and, optionally, triggers a callback function.

let mydata = ["KEY": "VALUE"]
// track call with type specified and completion block
tealium?.trackView(title: "EVENT_NAME",
      data: mydata,
      completion: { (success: Bool, info: [String:Any]?, error: Error?) in
//...
})

The value passed to title will appear in the data layer as the variable tealium_event.

Track Events

The track() method tracks an event with associated data and, optionally, triggers a callback function.

let mydata = ["KEY": "VALUE"]
// track call with type specified and completion block
tealium?.track(title: "EVENT_NAME",
      data: mydata,
      completion: { (success: Bool, info: [String:Any]?, error: Error?) in
 //...
})

The value passed to title will appear in the data layer as the variable tealium_event.

Event Batching

Swift does not currently use the Mobile Publish Settings, so event batching must be enabled and configured when the SDK is initialized.

This example enables event batching and sets the batch size and queue size.

import TealiumDispatchQueue // required for event batching options
class TealiumHelper {
	var tealium: Tealium?
	// ...

	private func initTealium() {
		let config = TealiumConfig(account: "ACCOUNT",
 	       		                   profile: "PROFILE",
                               environment: "ENVIRONMENT",
                               datasource: "DATASOURCE")
		config.setIsEventBatchingEnabled(true)      // enable batching
		config.setBatchSize(10)                     // size of batch
		config.setDispatchAfter(numberOfEvents: 25) // flush after every 25 events
		config.setMaxQueueSize(100)                 // 100 max queued events
		config.setBatchExpirationDays(5)            // events expire/delete after 5 days
		// ...
	}
}

The following options are available to customize event batching.

Method	Description
`setBatchExpirationDays()`	Sets the batch expiration in days. If the device is offline for an extended period, events older than this will be deleted.
`setBatchSize()`	Sets the amount of events to combine into a single batch request (max: 10).
`setDispatchAfter()`	Sets the number of events after which the queue will be flushed.
`setIsEventBatchingEnabled()`	Enables or disables event batching (default: `false`).
`setMaxQueueSize()`	Sets the maximum number of queued events. If this number is reached, and the queue has not been flushed, the oldest events will be deleted.

Tag Management

With Tag Management and event batching enabled, tracking calls are dispatched as individual JavaScript calls to the hidden webview.

Configured tags are triggered individually, resulting in multiple requests per event leaving the device. This improves device performance by waking up the device less frequently than sending real-time events.

Tealium Collect

This endpoint can currently only accept batch data generated by the Tealium SDK, in a proprietary batch format.

Trace

Join Trace

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

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

	func joinTrace(traceId id: String) {
		tealium?.joinTrace(traceId: "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” does 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(false)