トラック

ビューの追跡

画面のビューを追跡するには、TealiumView(viewName:dataLayer:)のインスタンスをtrack()メソッドに渡します。TealiumViewはビュー名とオプションのデータ辞書で構成され、追跡呼び出しではtealium_eventとして表示されます。

以下に例を示します：

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

イベントの追跡

ビュー以外のイベントを追跡するには、TealiumEvent(eventName:dataLayer:)のインスタンスをtrack()メソッドに渡します。TealiumEventはイベント名とオプションのデータ辞書で構成され、追跡呼び出しではtealium_eventとして表示されます。

以下に例を示します：

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

タイムドイベント

タイムドイベントは、イベントの持続時間または2つのイベント間の持続時間を測定します。タイムドイベントは自動的にまたは手動でトリガーされます。

自動トリガー

timedEventTriggersをTimedEventTriggerオブジェクトのリストに構成することで、イベント間の持続時間を自動的に追跡します。開始と停止のイベント名を指定します。

以下は、自動トリガーでタイムドイベントを追跡する例です：

config.timedEventTriggers = [TimedEventTrigger(
    start: "cart_add",
    stop: "purchase")]

手動トリガー

カスタムロジックに基づいてタイムドイベントを開始し停止することで、イベントの持続時間を手動で追跡します。

startTimedEvent()を使用してイベントの持続時間の追跡を開始します：

tealium.startTimedEvent(name: "TimeSpentViewingProduct")

stopTimedEvent()でタイムドイベントを停止します：

tealium.stopTimedEvent(name: "TimeSpentViewingProduct")

以前に開始したタイムドイベントをcancelTimedEvent()でキャンセルします：

tealium.cancelTimedEvent(name: "TimeSpentViewingProduct")

以前に開始したすべてのタイムドイベントをclearAllTimedEvents()でクリアします：

tealium?.clearAllTimedEvents()

トレース

トレースの参加

joinTrace()メソッドは、指定されたIDでトレースに参加します。Tealium Customer Data Hubのトレース機能について詳しく学びましょう。

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

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

トレースの離脱

トレースは、leaveTrace()メソッドが呼び出され、以前に参加したトレースを離脱し、訪問セッションを終了するまで、アプリセッションの期間中アクティブになります。

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

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

“End of Visit"で実行するように構成されたコネクタアクションは、セッションが期限切れになるまで実行されません。

トレースを離脱する際に訪問セッションを保持するには、以下の例のようにオプションの引数falseを渡します：

tealium?.leaveTrace(killVisitorSession: false)