ウェブサイト AOI におけるマウスの動作の追跡
ウェブサイトフレーム内では、マウスイベントと視線は同じ根本的な方法で記録されます: どちらも Website AOI 要素以外はターゲットにできず、それがウェブサイトフレームが含めることのできる唯一のオブジェクトです。このページでは、ウェブサイト AOI 上での Mouse Trigger イベントの構築について、完全に説明します。視線については、ウェブサイトフレームアイトラッキングウォークスルー を参照してください。そのトリガーのイベント設定はすでに詳細に説明されており、ここでは繰り返しません。
なぜここで設定が必要なのか、Labvanced の他の部分と異なり
ウェブサイトフレームの外では、マウストラッキングは主に機能します: フレームの連続したマウストラッキングプロパティがカーソルの動きを受動的に記録し、トリガーは必要ありません。ウェブサイトフレームの埋め込まれたページの内部では、その受動的なトラッキングは決して発火せず、参加者のブラウザは iframe 上でカーソルがある間、親ページにマウスの動きを届けません、Labvanced の設定に関係なく。Mouse Trigger は、Labvanced Web Bridge 拡張機能によってサポートされており、フレーム内部からのマウスデータを取得する唯一の方法です。これを構築しない場合、ウェブサイト AOI はマウスの動作に関する情報を何も記録せず、無言で、同じようにアンカーがない AOI が何も記録しないのと同じです。
3つのターゲティングモード
Mouse Trigger イベントを追加し、ウェブサイトフレーム内で、その Targets: セクションは、単一のターゲットピッカーの代わりに3つのモードを提供します:
| モード | 何をするか |
|---|---|
Any element in website frame | 埋め込まれたページのどこでも選択されたインタラクションが発火し、登録された AOI の上かどうかに関係なく。 |
Any AOI element | インタラクションが登録されたウェブサイト AOI の上で発生するたびに発火し、個別に選ぶ必要がない。 |
| 特定のターゲットを選択 (デフォルト、ボックスはどちらもチェックされていない) | 明示的にターゲットとして追加したウェブサイト AOI のみで発火します。 |
これは、同じフレーム上での視線に比べてより豊富な選択肢です: Eyetracking Gaze/Eyetracking Fixation トリガーは、2つのモードのみを提供し、Only trigger when looking at specific elements が未チェックであれば (新しい視線データが存在するたびに継続的に発火し、ターゲットなし)、チェックされていれば (特定の選択された AOI ターゲットに制限されます)。Any AOI element の視線の同等物はありません。
AOI が重なる場合、 ターゲティングモードはカウントするものを変えます。特定のターゲットが選択されている Click、PressDown、PressUp の場合、Labvanced はクリックポイントでのすべての AOI を確認し、視覚的に上にあるものだけでなく、異なる AOI がその上に重なっていても、ターゲットはまだ発火します。Any element in website frame および Any AOI element モード、および Hover/Leave/Move は、モードに関係なく、その地点での最上位の要素のみを考慮します。
イベントの構築
- 新しいイベントを追加し、
Mouse Triggerを選択します。 - 希望するインタラクションに
Action:を設定します:Click,PressDown,PressUp,Hover,Leave, またはMove。Click,PressDown, およびPressUpの場合、Button:ドロップダウンも表示され、LeftまたはRightを選択して、トリガーを1つのマウスボタンに制限します。 - 上記の表からターゲティングモードを選択します。両方のチェックボックスをチェックしない場合は、
Add Targetをクリックし、希望するウェブサイト AOI(s) を選択します。 - 実際にデータをキャッチするために
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)。 - 値の選択メニューで、
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] ArrayfromTrigger (Mouse)
これにより、登録されたすべての AOI 上でのマウスの動きごとに AOI の名前とラベルを、そのページ相対の X/Y と共に記録します。これには、各 AOI ごとに別のイベントを必要としません。
値の選択、およびそれに伴う座標空間
Trigger (Mouse) カテゴリは次のものを提供します:
| 値 | 何を提供するか |
|---|---|
MouseX / MouseY | 単独の X または Y 座標 |
Mouse [X,Y] Array | 両方の座標を一緒に |
Stimulus Name | AOI のオブジェクト名 |
Stimulus Info | AOI の 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 からマウスデータと視線データを組み合わせている場合、両者はこのページ相対座標空間を使用しているため、直接一致します。一方を他方に合わせて変換する必要はありません。
ページスクロール位置は別の値ではない
メインガイドのトラッキングデータリストではスクロール位置について言及していますが、「現在のスクロール位置」という独立した値を単独で記録することはできません。スクロールオフセットは、上で説明したページ相対座標 (Click, PressDown, PressUp, Move) にのみ適用され、自己記録可能な変数としては公開されていません。特に AOI 内のスクロール可能なサブリージョンのスクロール動作が必要な場合は、別の設定 (Scrollable container) を AOI 自体に適用する必要があり、スクロール可能なサブリージョンのトラッキング で説明されており、その結果得られるデータは 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 はページに対して相対的です。値の選択 を参照してください。
よくある質問
なぜフレームの通常のマウストラッキング設定がウェブサイトフレーム内で機能しないのですか？
マウスの動きを追跡する前にウェブサイト AOI を追加する必要がありますか？
Any AOI element モードを使用したりする場合のみ必要です。Any element in website frame モードは、インタラクションが登録された AOI の上かどうかに関係なく発火するため、AOI がまったく追加されていなくても機能します。 なぜ同じ AOI で Hover 座標が Click 座標よりもずっと小さいのですか？
Hover/Leave は AOI 要素自体に対して相対的な座標を報告し、一方で Click/PressDown/PressUp/Move はページ全体に対して相対的な座標を報告します。両方は同じ MouseX/MouseY 値名を使用しているため、値ピッカーからはこれが見えません。 ウェブサイトフレーム内の Any element と Any AOI element の違いは何ですか？
Any element in website frame は、埋め込まれたページのどこでもインタラクションのために発火し、AOI かどうかに関係ありません。Any AOI element は、インタラクションが登録されたウェブサイト AOI の上で発生する場合にのみ発火しますが、どの AOI を選ぶ必要もなく、どれでも大丈夫です。