トラッキング
ユーザー活動の追跡方法について学びます。
ビューのトラッキング
画面ビューを追跡するには、TealiumView(viewName:dataLayer:)
のインスタンスをtrack()
メソッドに渡します。TealiumView
はビュー名とオプションのデータ辞書で構成され、追跡呼び出しではtealium_event
として表示されます。
以下に例を示します:
val tealView = TealiumView("VIEW_NAME", mutableMapOf("KEY" to "VALUE"))
tealium.track(tealView);
以下を置き換えてください:
VIEW_NAME
を追跡したい画面ビューの名前に置き換えます。KEY:VALUE
:追跡したいイベントに関連するデータのキーと値のペアのオブジェクト。
イベントのトラッキング
非ビューイベントを追跡するには、TealiumEvent(eventName:dataLayer:)
のインスタンスをtrack()
メソッドに渡します。TealiumEvent
はイベント名とオプションのデータ辞書で構成され、追跡呼び出しではtealium_event
として表示されます。
以下に例を示します:
val tealEvent = TealiumEvent("EVENT_NAME", mutableMapOf("KEY" to "VALUE"))
tealium.track(tealEvent);
以下を置き換えてください:
EVENT_NAME
を追跡したい非ビューイベントの名前に置き換えます。KEY:VALUE
:追跡したいイベントに関連するデータのキーと値のペアのオブジェクト。
タイムドイベント
タイムドイベントは、イベントの持続時間または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")
以下を置き換えてください:
INSTANCE_NAME
:Tealium Kotlinライブラリを初期化する際に使用したインスタンス名。TRACE_ID
:参加したいトレースのID。
トレースの離脱
トレースはアプリセッションの期間中有効で、以前に参加したトレースを離脱し、訪問者セッションを終了するleaveTrace()
を呼び出すまで続きます。
Tealium["INSTANCE_NAME"]?.leaveTrace()
訪問者セッションをリモートで終了するには、endTraceVisitorSession()
を使用します。これにより、SDKセッションは終了せず、セッションIDもリセットされません。
Tealium["INSTANCE_NAME"]?.endTraceVisitorSession()
最終更新日 :: 2024年May月15日