タイムライン属性 | データ型 | Tealiumドキュメント

仕組み

タイムライン属性は、指定された期間にわたるイベントのリストを記録します。キャプチャされたイベントは、キャプチャされた属性値とタイムスタンプを含むタイムライン内のエントリを生成します。タイムスタンプは、イベントの時間または他の属性によって提供される日付/時間にすることができます。タイムスタンプはUnix/Epoch形式で記録されます。

サイズ制限

タイムライン属性は最大100エントリに制限されています。タイムラインがこの制限に達すると、最初のエントリが破棄されます（先入れ先出し）。例えば、タイムラインに100エントリが含まれていて、新しいエントリが追加された場合、最初のエントリが削除されます。

タイムライン属性はまた、暗号化と圧縮後のプロファイルの最大サイズ（400 KB）によって制限されます。

属性データのキャプチャ

イベントのタイムスタンプに加えて、イベントが発生したときの1つ以上の属性の値もキャプチャすることができます。キャプチャされた属性値は、イベントが発生したときの詳細情報を提供します。数値と集計のみがキャプチャに有用な属性タイプであり、これらの属性タイプのみがエンリッチメントを使用して集計することができます。

例えば、各購入の注文合計を追跡するためには、購入タイムラインで属性order_totalをキャプチャします。

タイムラインをTraceで最新の訪問プロファイルを表示して確認します。

エントリの有効期限

タイムライン内のエントリは、構成された日数後に有効期限が切れるように構成することができます。この有効期限は、タイムライン内のエントリにのみ適用され、タイムライン属性自体には適用されません。有効期限は、各訪問の開始時に評価されます。エントリが有効期限より古い場合、タイムラインから削除されます。

タイムラインは数値と相性が良いです。なぜなら、数値のエントリはタイムラインのエントリに基づいてローリング合計やローリング平均値を作成するのに容易に使用できるからです。

スコープ

タイムライン属性は、訪問と訪問のスコープで利用可能です。

イベント	訪問	訪問
✗	✓	✓

ベストプラクティス

タイムラインは100エントリに制限されています。他の属性と同様に、400KB圧縮の最大訪問プロファイルサイズに寄与します。

タイムライン属性を効率的に使用するために、以下を推奨します：

必要以上にタイムラインに情報を保存しないでください。タイムラインエントリの有効期限を構成します。
特別な使用ケースがない限り、タイムラインに他の属性を保存しないでください。例えば、AudienceStoreや他のコネクタにタイムラインエントリを送信するなどのケースです。タイムラインにはほとんどの属性タイプを保存できますが、数値と集計のみがタイムラインから他のAudienceStream属性にエンリッチできます。例えば、タイムラインのエントリから数値の合計を取得したり、タイムラインのエントリから集計を集計したりすることができます。他の属性タイプを保存することもできますが、保存した値を集計するエンリッチメントはありません。
タイムラインエントリに他の属性を保存すると、訪問プロファイルのサイズが増えます。
戦略的に使用することで、タイムライン内のエントリ数とタイムラインの総数を最小限に抑えることができます。
- タイムライン属性を使用してイベントを効率的にカウントするには、ターゲットイベントが発生したときに訪問数を増やし、訪問の終了時に訪問数をタイムラインに保存します。
- 訪問の開始時に全体のカウントを取得するには、合計エンリッチメントを使用してタイムライン属性内の訪問を加算し、それらを数値属性に保存します。これにより、訪問中にこの数値を増やすことで、完全に最新の状態を保つことができます。
- 同じ期間に複数の数値を保存する場合は、すべてを1つのタイムラインに保存します。

エンリッチメント

タイムラインの更新

このエンリッチメントを使用して、タイムラインにエントリを記録します。このエンリッチメントを追加するには、エントリを作成をクリックし、タイムラインを更新を選択します。

エントリのタイムスタンプを記録するための以下のオプションから一つを選択します：

イベント受信時の時間（デフォルト）
エントリのタイムスタンプは、イベントが発生したときに自動的に構成されます。
日付に基づく
エントリのタイムスタンプは、別の属性の値に構成されます。文字列属性を選択した場合、日付フォーマッターを使用して、期待される値に一致する日付/時間パターンを作成する必要があります。

エントリに属性値をキャプチャするには、ドロップダウンリストから属性を選択し、属性を追加をクリックします。追加された属性はキャプチャされた属性として表示されます。エントリにキャプチャする各属性について、この手順を繰り返します。

例

属性名: 過去60日間の注文
キャプチャされた属性: order_subtotal と order_total

例のJSONデータ:

"過去60日間の注文" : [
  {
    "timestamp" : 1576862494000,
    "snapshot" : {
      "order_total" : 44.00,
      "order_subtotal" : 38.00
    }
  },
  {
    "timestamp" : 1577640094000,
    "snapshot" : {
      "order_total" : 100.00,
      "order_subtotal" : 95.00
    }
  },
  {
    "timestamp" : 1578849694000,
    "snapshot": {
      "order_total" : 60.00,
      "order_subtotal" : 59.00
    }
  }
]

タイムラインイベントの有効期限構成

このエンリッチメントを使用して、エントリがタイムラインから削除されるべき日数を決定します。記録されてからの日数が有効期限構成よりも古い各エントリは、自動的にタイムラインから削除されます。タイムラインエントリの有効期限は、訪問の開始時に評価されます。

有効期限はタイムライン自体には適用されず、その中のエントリにのみ適用されます。