タイムドイベント

サポートされているプラットフォーム

以下のプラットフォームではタイムドイベントがサポートされています：

• Android (Kotlin)
• iOS (Swift v2.x)

仕組み

タイムドイベントは、イベントの持続時間や2つのイベント間の時間を測定し、自動または手動のトリガーで構成します。タイムドイベントが完了すると、タイムドイベントの名前とタイミングの詳細を持つtimed_eventという名前のイベントをTealium EventStreamに送信します。

すでにアプリで追跡されているTealiumイベント間の持続時間を測定するために自動トリガーを使用します。指定した開始イベントが発生すると自動的にタイムドイベントがトリガーされ、指定した停止イベントが発生すると停止します。

Tealiumで追跡されていないイベントや、複雑なイベントのシーケンスを含むイベント間の持続時間を測定するために手動トリガーを使用します。タイムドイベントは、カスタムロジックに基づいてアプリコードでタイムドイベントを開始および停止することで手動でトリガーされます。

各タイムドイベントには、イベント属性timed_event_nameに構成された名前があります。タイムドイベントが終了した後にイベント名を再利用することは可能ですが、同時に複数のタイムドイベントが同じ名前を使用することはできません。

タイムドイベントは永続的ではなく、イベントが終了する前にアプリが終了すると破棄されます。

タイムドイベントの使用方法を学びましょう：

• Android Kotlin
• iOS (Swift v2.x)

自動トリガー

自動トリガーでタイムドイベントを追跡するには、開始と停止のTealiumイベント名を指定します。これらのイベントはすでにアプリで追跡されている必要があります。自動タイムドイベントの名前は、開始と停止のイベント名を二つのコロン(::)で結合して生成されます。例えば、cart_addイベントとpurchaseイベントの間の持続時間を追跡するために自動トリガーを構成すると、イベント属性timed_event_nameはcart_add::purchaseに構成されます。

val config = TealiumConfig(…).apply {
   timedEventTriggers = mutableListOf(EventTrigger.forEventName(
        "cart_add",
        "purchase"))
}

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

自動トリガーからの結果となるタイムドイベント：

{
  "tealium_event": "timed_event",
  "timed_event_name": "cart_add::purchase",
  "timed_event_start": "1605645967299",
  "timed_event_end": "1605645968401",
  "timed_event_duration": "1102"
}

手動トリガー

手動トリガーでタイムドイベントを追跡するには、タイムドイベントの名前を指定し、アプリコードでタイムドイベントを手動で開始および停止します。例えば、ユーザーが製品を閲覧する時間を手動で追跡するには、製品画面がロードされたときにタイムドイベントを開始し、ユーザーが製品画面を離れたときにタイムドイベントを停止します。タイムドイベントに使用する名前は、イベント属性timed_event_nameの値に構成されます。

手動でタイムドイベントを開始する：

tealium.startTimedEvent(name: "TimeSpentViewingProduct")

手動でタイムドイベントを停止する：

tealium.stopTimedEvent(name: "TimeSpentViewingProduct")

手動トリガーからの結果となるタイムドイベント：

{
  "tealium_event": "timed_event",
  "timed_event_name": "TimeSpentViewingProduct",
  "timed_event_start": "1605645967299",
  "timed_event_end": "1605645968401",
  "timed_event_duration": "1102"
}

データレイヤー

タイムドイベントは、イベント名timed_eventと以下の属性で追跡されます：

以下はタイムドイベントの例です：

{
  "tealium_event": "timed_event",
  "timed_event_name": "cart_add::purchase",
  "timed_event_start": "1605645967299",
  "timed_event_end": "1605645968401",
  "timed_event_duration": "1102"
}