トランザクションマネージャー:トランザクションメトリクス API

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:2分
  • API 呼び出しを使用して、ユーザービュー、ユーザーセッション時間、ステージで費やした時間を取得します。

    トランザクションマネージャーは、トランザクションのメトリクスを取得するための API を提供します。メトリクスには、ユーザー別のビュー、ユーザー別のセッション時間、ステージ時間が含まれます。

    トランザクション ID を送信することで、単一のトランザクションをクエリできます。トランザクション ID が指定されていない場合は、すべてのトランザクションデータが返されます。

    デフォルトでは、コールは過去 30 日間のメトリクスを返します。日付範囲パラメーターを含めることで、さまざまな期間を指定できます。日付範囲パラメーターは toDatedays を指定し、 (toDate - days) -> toDate から統計情報を取得します。toDate が指定されていない場合は、現在の時刻が想定されます。

    呼び出し例:

    curl -X GET "{{baseUrl}}/api/txn/metrics/v1/overview?txnId={{transactionId}}&days=30&toDate=2025-09-18T15:28:04Z" \
      -H "X-Logik-Customer-Id: <tenant-id>" \
      -H "Content-Type: application/json"

    測定基準の詳細

    ユーザー別のビュー:

    • 指定された期間のユーザーの合計セッション数
    • 単位:カウント

    単一のトランザクションにフィルタリングすると、セッションはそのトランザクションのみを対象とします。

    ユーザー別のセッション時間:

    • 各ユーザーのセッションあたりの平均時間
    • 単位:分

    セッションは、作成または編集されたトランザクション、ステージの開始または終了、ラインのアップサート、カスタムトランザクションイベントなどの一般的なイベントに基づいて、アクティビティウィンドウを使用して計算されます。最後のイベントの後、セッションを終了するまでに 5 分のしきい値があります。

    単一のトランザクションにフィルタリングした場合、ユーザーあたりのビューにユーザーあたりのセッション時間を乗算することで、ユーザーの合計時間を計算できます。

    ステージ時間:

    • トランザクションが指定されたステージで費やした平均時間
    • 単位:分

    単一のトランザクションにフィルタリングされた場合、メトリクスにはトランザクションが指定されたステージにあった時間が反映されます。