トラッキング

ビューのトラッキング

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

以下に例を示します：

val tealView = TealiumView("VIEW_NAME", mutableMapOf("key" to "value"))
tealium.track(tealView);

イベントのトラッキング

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

以下に例を示します：

val tealEvent = TealiumEvent("EVENT_NAME", mutableMapOf("key" to "value"))
tealium.track(tealEvent);

タイムドイベント

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

自動トリガー

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

以下は、自動トリガーでタイムドイベントをトラッキングする例です：

timedEventTriggers = mutableListOf(EventTrigger.forEventName(
    "cart_add",
    "purchase"))

手動トリガー

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

startTimedEvent()でイベントの持続時間のトラッキングを開始します。

tealium.startTimedEvent(name: "TimeSpentViewingProduct")

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

tealium.stopTimedEvent(name: "TimeSpentViewingProduct")

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

tealium.cancelTimedEvent(name: "TimeSpentViewingProduct")

トレース

トレースの参加

指定されたIDでトレースに参加するには、joinTrace()を呼び出します。Tealium Customer Data HubのTrace機能について詳しくはこちらをご覧ください。

Tealium["INSTANCE_NAME"]?.joinTrace("TRACE_ID")

トレースの離脱

トレースはアプリセッションの期間中有効で、以前に参加したトレースを離脱し、訪問セッションを終了するまでleaveTrace()を呼び出すまで続きます。

Tealium["INSTANCE_NAME"]?.leaveTrace()

訪問セッションをリモートで終了するには、endTraceVisitorSession()を使用します。これにより、SDKセッションは終了せず、セッションIDもリセットされません。

Tealium["INSTANCE_NAME"]?.endTraceVisitorSession()