トラッキング

ビューのトラッキング

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

以下に例を示します：

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

以下を置き換えてください：

• VIEW_NAME：追跡したい画面ビューの名前。
• KEY:VALUE：追跡したいイベントに関連するデータのキーと値のペアのオブジェクト。

イベントのトラッキング

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

以下に例を示します：

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

以下を置き換えてください：

• EVENT_NAME：追跡したい非ビューイベントの名前。
• KEY:VALUE：追跡したいイベントに関連するデータのキーと値のペアのオブジェクト。

タイムドイベント

タイムドイベントは、イベントの持続時間または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")
		// ...
	}
}

TRACE_IDを参加したいトレースのIDに置き換えてください。

トレースの離脱

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

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

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

コネクタアクションが"End of Visit"で設定されている場合、セッションが期限切れになるまで実行されません。

トレースを離れるときにトレース訪問者セッションを保持するには、次の例に示すようにオプションの引数falseを渡します：

tealium?.leaveTrace(killVisitorSession: false)