ユーザーアクションの追跡¶
ブラウザモニタリングは、ユーザーのインタラクションを自動的に検出し、ユーザーの行動を詳細に把握します。アプリケーション内のすべてのクリックを手動で検出する必要はありません。
以下の目標を達成できます：
- キーとなるインタラクションのパフォーマンスを把握する（例：操作ボタンのクリック）
- 機能の採用状況を定量化する
- 特定のブラウザエラーに至る手順を特定する
Action 収集の有効/無効を制御する¶
trackUserInteractions 初期化パラメータは、アプリケーション内のユーザークリックを収集します。つまり、ユーザーが操作した要素を特定するために、ページに含まれる機密データやプライベートデータが収集される可能性があります。
ユーザーインタラクションの追跡¶
RUM SDK は自動的にクリックを追跡します。以下のすべての条件を満たす場合、クリックアクションが作成されます：
- クリック後にアクティビティが検出された場合、すなわちページアクティブ状態であること；
- クリックによって新しいページが読み込まれない場合（この場合、RUM SDK は別の RUM View イベントを生成します）；
- Action 名が取得できること。
Action メトリクス¶
| メトリクス | タイプ | 説明 |
|---|---|---|
action.duration |
number(ns) | アクションのロード時間。 |
action.action_long_task_count |
number | このアクションで収集されたすべてのロングタスクの数。 |
action.action_resource_count |
number | このアクションで収集されたすべてのリソースの数。 |
action.action_error_count |
number | このアクションで収集されたすべてのエラーの数。 |
RUM SDK は、各クリック後のページアクティビティを監視してアクションのロード時間を計算します。ページにアクティビティがなくなると、アクションは完了と見なされます。
Action 属性¶
| 属性 | タイプ | 説明 |
|---|---|---|
action.action_id |
String | ユーザーアクションの UUID |
action.action_type |
String | ユーザーアクションのタイプ。カスタムユーザーアクションの場合は custom に設定されます。 |
action.action_target |
String | ユーザーが操作した要素。自動収集されたアクションにのみ適用されます。 |
action.action_name |
String | ユーザーフレンドリーな名前（例："Click on #checkout"）を作成します。カスタムユーザーアクションの場合は、API 呼び出しで指定されたアクション名です。 |
Action 操作の名前¶
RUM SDK は、クリック可能な要素とその親要素に基づいて Action 名を推測します。自動生成された名前が不十分な場合は、組み込み属性を使用して明示的に名前を付けることができます。
クリック可能な要素またはその親要素に data-guance-action-name を追加します：
actionNameAttribute 初期化パラメータを使用すると、要素にカスタム属性を追加してアクションの名前を指定できます。
初期化時に属性名を指定します：
window.DATAFLUX_RUM &&
window.DATAFLUX_RUM.init({
// 他の初期化設定
trackUserInteractions: true,
actionNameAttribute: "data-custom-name"
})
クリック可能な要素またはその親要素に対応する属性を設定します：
要素に組み込み属性と actionNameAttribute で設定されたカスタム属性の両方が存在する場合、組み込み属性が優先されます。
カスタム Action¶
クリックで表現できないビジネス操作については、addAction API を使用してカスタムアクションを作成してください。
接続確認¶
- 明確な名前が付いたボタンをクリックします。
- ブラウザの Network で
/v1/write/rumへの送信リクエストが存在することを確認します。 - 対応する Web アプリケーションの Action エクスプローラーで、Action 名、持続時間、および関連する Resource と Error の数を確認します。
Action がない場合は、trackUserInteractions が true であるか、現在の Session がサンプリングの対象外であるか、クリック後に帰属可能なページアクティビティが発生したかを順に確認してください。