ウェブサイトのAOIでのマウス行動のトラッキング

ウェブサイトフレーム内では、マウスイベントと視線は同じ基盤で記録されます：どちらもWebsite AOI要素以外をターゲットにすることはできず、それがウェブサイトフレームが含むことのできる唯一のオブジェクトです。このページでは、ウェブサイトAOIでMouse Triggerイベントを構築する方法を詳細に説明します。視線については、ウェブサイトフレーム視線トラッキングウォークスルーを参照してください。そこでそのトリガー自身のイベント設定がすでに詳細に説明されており、ここでは繰り返しません。

Labvancedの他の場所とは異なり、ここでの設定が必要な理由

ウェブサイトフレームの外では、マウストラッキングはほとんどそのまま機能します：フレームの連続マウストラッキングプロパティは、トリガーを必要とせずにカーソルの動きをパッシブに記録します。ウェブサイトフレーム内の埋め込まれたページ内では、そのパッシブトラッキングは決して発動しません。参加者のブラウザは、カーソルがiframe上にある間、マウスの動きを親ページに送信しないからです。Mouse Triggerは、Labvanced Web Bridge拡張機能によってサポートされており、フレーム内からマウスデータを取得する唯一の方法です。これを構築しないと、ウェブサイトAOIはマウスの行動について何も記録しません。無反応のAOIがあなたに気付かれないまま何も記録しないのと同じです。

3つのターゲティングモード

Mouse Triggerイベントを追加し、ウェブサイトフレーム内では、そのTargets:セクションが1つのターゲットピッカーの代わりに3つのモードを提供します：

モード機能
Any element in website frame埋め込まれたページ内のどこでも選択されたインタラクションが発動し、登録されたAOIの上で発生するか否かに関わらず機能します。
Any AOI element登録されたウェブサイトAOIの上でインタラクションが発生するたびに発動し、個別に選択する必要はありません。
特定のターゲットを選択（デフォルト、どちらのボックスも未チェック）明示的に追加したウェブサイトAOIのためにのみ発動します。

これは、同じフレーム上の視線が得る選択肢よりも豊かです：Eyetracking Gaze/Eyetracking Fixationトリガーは、Only trigger when looking at specific elementsが未チェック（新しい視線データが存在するたびに常に発動）か、チェックされている場合（特定の選択したAOIターゲットに制限される）という2つのモードしか提供していません。Any AOI elementの視線に相当するものはありません。

**AOIが重なっている場合、**ターゲティングモードによって何がカウントされるかが変わります。Click、PressDown、およびPressUpで特定のターゲットが選択されている場合、Labvancedはクリックポイントで各AOIをチェックし、視覚的に上にあるものだけではなく、異なるAOIがそこにスタックしていてもターゲットが発動します。Any element in website frameおよびAny AOI elementモード、Hover/Leave/Moveは、モードに関係なく、その時点での一番上の要素だけを考慮することしかありません。

イベントの構築

  1. 新しいイベントを追加し、Mouse Triggerを選択します。
  2. 希望するインタラクションをAction:に設定：Click、PressDown、PressUp、Hover、Leave、またはMove。Click、PressDown、およびPressUpの場合、Button:ドロップダウンも表示され、LeftまたはRightで、トリガーを1つのマウスボタンに制限します。
  3. 上記の表からターゲティングモードを選択します。両方のチェックボックスを未チェックのままにすると、Add Targetをクリックして、希望するウェブサイトAOIを選択します。
  4. 実際にデータをキャプチャするためにSet / Record Variableアクションを追加します。アクションなしのイベントは何も記録せず、Eyetracking Gazeイベントが関連付けられたAOIと同様です。変数の形式をArrayに設定します。レコードタイプについて、Final valueは最も最近の発生だけを保持し、Time seriesはすべてを保持します。Time seriesを選択すると、さらなるSampling methodオプションが表示されます：record all (allow repeated duplicates)またはrecord changes only (no repeated duplicates)。
  5. 値選択メニューでTrigger (Mouse)カテゴリから選択します。ここにこのイベントに特有の値が保存されており、次のセクションで説明されます。

トリガー: Mouse Trigger → Action: Move → Targets: Any AOI element
アクション: Set / Record Variable → 形式: Array, レコードタイプ: Time series, サンプリング方法: record all (allow repeated duplicates) → 値: Mouse [Name, Info, X, Y] Array from Trigger (Mouse)

これにより、登録されたAOIの上でのマウス移動ごとに、そのページ相対X/Yと共にAOIの名前とラベルが記録され、AOIごとに別々のイベントを必要とせずに済みます。

値の選択とそれに伴う座標空間

Trigger (Mouse)カテゴリは以下を提供します：

値それが提供するもの
MouseX / MouseYXまたはY座標自体
Mouse [X,Y] Array両方の座標を合わせて
Stimulus NameAOIのオブジェクト名
Stimulus InfoAOIのStimulus Infoラベル
Element Textイベント発生時のAOIの可視テキスト
Mouse [Name, Info, X, Y] Array名前、Stimulus Info、および両方の座標を合わせて
Mouse [Name, Info, Text, X, Y] Array名前、Stimulus Info、可視テキスト、そして両方の座標を合わせて

MouseX/MouseY（およびそれから構築された配列）は、すべてのインタラクションタイプで同じ意味ではありません：

  • Click、PressDown、PressUp、Moveはページ相対座標を報告し、埋め込まれたページのフルスクロール可能エリアにおける位置を示し、参加者がスクロールした領域を含みます。
  • Hover、Leaveはその代わりに要素相対座標を報告し、AOI自体の位置を示します。ページではありません。

両者は、値ピッカー内では同じラベル（MouseX、MouseY）が付けられていますが、インターフェース内では、イベントが構築されているインタラクションタイプ以外にそれらを区別するものはありません。HoverイベントとMoveイベントのデータを同じエクスポートされた列に混ぜると、警告なしに異なる2つの座標空間が混在します。記録アクションを配線する前に、実際に必要なインタラクションタイプを最初に決定してください。

Stimulus NameおよびStimulus Infoは、イベントが発火したAOIを特定します。これは、エクスポートデータのためのAOIの命名でカバーされている同じStimulus Infoラベルで、複数のAOIから記録する場合やAny AOI elementモードから記録する場合に便利です。Element Textは、イベントの瞬間のAOIの可視テキストを持ちます。

共有された視線：ページ相対座標にはスクロールが含まれます

上記で説明されたページ相対座標（Click、PressDown、PressUp、Move用）は、iframeの内部スクロールオフセットを含みます。現在表示されているビューポート内のものだけではありません。ウェブサイトAOIで記録される視線座標も同じ方式で機能します。分析中にマウスデータと視線データを同じAOIから組み合わせる場合、両方はこの同じページ相対座標空間を使用するため、直接一致します。一方を他方に合わせて変換する必要はありません。

ページのスクロール位置は別個の値ではない

メインガイドのトラッキングデータリストではスクロール位置が言及されていますが、単独の「現在のスクロール位置」値を記録することはできません。スクロールオフセットは、上記で説明したページ相対座標内で自動的に適用されることだけがあり、独自に記録可能な変数として公開されることはありません。具体的にAOI内のスクロール可能なサブリージョンでのスクロール動作が必要な場合、それは別の設定で、AOI自体のScrollable containerであり、スクロール可能なサブリージョンのトラッキングでカバーされています。その結果得られるデータは、Eyetracking Gaze/Eyetracking Fixationトリガーを通じてのみ利用可能で、Mouse Triggerではありません。

トラブルシューティング

イベントが全く発火しない。 Web Bridge拡張がインストールされ、動作していることを確認します。これがないと、ウェブサイトフレーム内でMouse Triggerに到達するものは何もありません。特定のターゲットを使用している場合、選択したAOIが実際に固定されていることを確認してください。アンクリップされたAOI (selectorFound が false) は、トリガー自体が正しく設定されている場合でも、ターゲットイベントを発火しません。

間違った要素に対して発火する、または頻繁すぎる。 どのターゲティングモードが選択されているか確認します。Any element in website frameは、AOIの外も含めてどこでも発火します。それが求めているものでない場合は、Any AOI elementに切り替えるか、特定のターゲットを代わりに選択してください。

記録された座標が間違っているか、一貫性がない。 イベントが使用しているインタラクションタイプを確認します。Hover/Leave座標はAOIに対して相対的で、Click/PressDown/PressUp/Moveはページに対して相対的です。上記の値の選択を参照してください。

よくある質問

なぜフレームの通常のマウストラッキング設定はウェブサイトフレーム内で機能しないのですか？
参加者のブラウザがカーソルがiframe上にある間、マウスの動きを親ページに送信しないためです。これは標準的なブラウザの動作であり、Labvancedの制限ではありません。埋め込まれたページ内のマウス活動を確認できるのは、Web Bridge拡張の独自のイベントストリームのみ、すなわちマウストリガーを介してです。
マウスの動きをトラッキングする前にウェブサイトAOIを追加する必要がありますか？
特定の要素をターゲットにしたい場合や任意のAOI要素モードを使用する場合だけです。ウェブサイトフレームの任意の要素モードは、インタラクションが登録されたAOIの上で発生するかどうかに関わらず発火するため、AOIを追加しなくても機能します。
なぜ同じAOIでのHover座標がClick座標よりも大幅に小さいのですか？
同じことを測定しているわけではありません。Hover/LeaveはAOI要素自体に対する座標を報告しますが、Click/PressDown/PressUp/Moveはページ全体に対する座標を報告します。両方は同じMouseX/MouseY値名を使用しているため、値ピッカーだけではこのことは確認できません。
ウェブサイトフレームの任意の要素と任意のAOI要素の違いは何ですか？
ウェブサイトフレームの任意の要素は、埋め込まれたページ内のどこにでもインタラクションについて発火します。AOIに関わらずです。任意のAOI要素は、インタラクションが登録されたウェブサイトAOIの上で発生したときのみ発火しますが、どのAOIを選択する必要はなく、どれでも機能します。

さらなる読み物

Labvanced Web Bridge | サポート & ガイド

完全なリファレンス：インストール、ユースケース、データとプライバシー、トラブルシューティング、FAQ。

ウェブサイトAOIの選択と調整

イベントを構築する前にウェブサイトAOIを固定、調整、検証します。

ウェブサイトフレーム視線トラッキングウォークスルー

視線トラッキングイベントの完全な設定、視線トラッキングイベント設定ダイアログを含みます。