Labvanced Web Bridge — 拡張機能のサポートとガイド

ヘルプが必要ですか？ [email protected]までご連絡ください。

目次

1. Labvanced Web Bridgeとは何ですか？

Labvanced Web Bridgeは、Labvanced実験プラットフォーム (labvanced.com)と実際のウェブサイトを接続するGoogle Chromeのブラウザ拡張機能です。この拡張機能により、研究者は参加者がライブのサードパーティウェブサイトと対話する制御されたUX研究や行動研究を実施でき、Labvancedがウェブカメラを介して眼球運動やマウスクリック、ホバーイベント、スクロール動作を記録します。

この拡張機能がないと、ブラウザは標準のセキュリティ制限により、ウェブサイトを研究研究に埋め込むことを防ぎます。この拡張機能は、制御されたLabvanced研究セッション内でのみこれらの制限を解除し、埋め込まれたサイトでの参加者の対話を測定するために必要な行動追跡機能を追加します。

Labvancedを使用して埋め込まれたウェブサイト

2. インストール

ステップバイステップ

研究者

  1. Google Chromeに移動します。
  2. Labvanced Web BridgeのChromeウェブストアページに行きます。
  3. **「Chromeに追加」**をクリックします。
  4. 確認ダイアログで**「拡張機能を追加」**をクリックします。
  5. ChromeツールバーにLabvanced Web Bridgeアイコンが表示されます。

ChromeにインストールされたLabvanced Web Bridge拡張機能

参加者

  1. インストールをクリックします。
  2. **「Chromeに追加」**をクリックします。
  3. 確認ダイアログで**「拡張機能を追加」**をクリックします。
  4. 実験に戻り、ページを更新して研究を開始します。

拡張機能がアクティブであることの確認

研究者 インストール後、Dashboardタブに移動し、New Studyを作成します。下にスクロールし、Track External Website: のチェックボックスを確認して、ターゲットウェブサイトのURLを入力します。拡張機能が正しくインストールされている場合、Labvancedエディタは緑のチェックマークと確認メッセージを表示します。

Labvancedで新しい研究を作成した際の緑の確認メッセージ

参加者

実験ページを更新すると、研究が進行します。

参加者にchrome拡張機能のインストールを促す

3. 誰がこれをインストールすべきですか？

研究者

以下のような場合は拡張機能をインストールしてください：

  • 実際のウェブサイトを刺激として含む研究を設計している（例：商品ページ、ニュース記事、キオスクインターフェースのテスト）。
  • LabvancedエディタでWebsite Frame要素を使用している。
  • 外部ウェブサイトを含む研究をプレビューまたはパイロットしている。

標準のLabvanced刺激（画像、動画、テキスト、フォームなど）だけを使用する研究や、自分のウェブサイトのHTTPヘッダーを直接編集しコントロールできるウェブサイトの所有者である場合、この拡張機能は必要ありません。

研究参加者

以下の場合は拡張機能をインストールしてください：

  • 研究リンクを受け取り、開始前にインストールするように指示された。
  • 研究のオンボーディングページで、拡張機能のインストールを確認するように求められた。

必要かどうかわからない場合、研究リンクページで研究開始前に判断されます。

4. 使用方法 — 研究者ガイド

4.1 あなたの研究にウェブサイトフレームを追加する

  1. Labvancedエディタで実験を開きます。
  2. Trial Timelineの下で、+ Websiteフレームオプションをクリックします。
  3. 要素タイプから**「Website Frame」**を選択し、次にExternal Websiteオプションを選択します。拡張機能がアクティブであれば、緑の確認メッセージが表示されます。そうでなければ、上記のインストール手順を参照してください。
  4. 前のステップで作成したタスクに指定したウェブサイトが自動的に表示されます。

4.2 興味のある領域（AOI）の選択

興味のある領域（AOI）は、埋め込まれたウェブサイト上で追跡したい特定の要素です。例えば、商品画像、見出し、「カートに追加」ボタンなどです。

  1. エディタでウェブサイトフレームがアクティブで、ウェブサイトがインタラクティブに表示されているとき、サイドメニューからAdd Website AOIオブジェクトをクリックします。
  2. AOIオブジェクトが追加され、赤で表示されます。ターゲットAOIをクリックします。選択は緑に変わります。
  • AOI選択を変更したい場合は、選択のParentを指して、ウェブサイトの大部分を移動したり選択したり、選択のChildを選択して、より特定のコンポーネントを選択できます。一度AOIが固定され（緑で表示され）、サイズオフセットを増加させることもできます。つまり、各側のx座標とy座標のピクセルを増やしたり減らしたりすることができます。また、その位置も変更できます。
  • Resolutionオプションを使用して、研究がデスクトップ向けかモバイル向けかを示すこともできます。下の画像ではモバイルが選択され、AOIが自動的に更新されました。
  1. 追加の要素に対して繰り返します。
  2. 各AOIはAOIリストに表示され、研究中に自動的に追跡されます。

モバイルベースのウェブサイト埋め込みとAOIプレビュー

4.3 追跡されるもの

研究セッション中の各AOIに対して、Labvancedは研究者に以下の行動データを記録する可能性を提供します：

データタイプ説明
要素の位置画面上の要素のバウンディングボックス（x、y、幅、高さ）。参加者がスクロールする際にリアルタイムで更新されます。
視線データウェブカメラを用いたアイ・トラッキングで、要素の位置にマッピングされます（研究設定でアイ・トラッキングを有効にする必要があります）。
クリックイベント参加者が要素内でクリックしたかつその位置。
ホバーイベント参加者のマウスが要素内に入ったり、出たりした時。
マウス移動参加者がページを移動する際のマウス座標。
スクロール位置各時点でのページスクロールオフセット。

4.4 研究のプレビュー

公開する前に、必ず拡張機能がインストールされていることを確認して研究をプレビューしてください：

  • ウェブサイトがフレーム内で正しく読み込まれる。
  • AOIが期待通りに機能する。

最初にタスクを保存し、次にエディタツールバーのTask Controlsの下にある**「プレビュー」**再生ボタンをクリックして、特定のタスクの参加者ビューのプレビューを開きます。

4.5 公開と共有

研究の準備ができたら：

  1. Launch & Participateタブに移動します。
  2. Activateボタンをクリックして研究のデータ記録を有効にします。
  3. Online Participation / Study Publishedの下で、Publish.をクリックします。
  4. Online Participation Linkをコピーして、参加者と共有します。

5. 使用方法 — 参加者ガイド

研究開始前

  1. 研究者からLabvanced研究の直接リンクを受け取ります。
  2. 拡張機能がまだインストールされていない場合、研究ページにはインストールプロンプトが表示され、Chromeウェブストアへの直接リンクが表示されます。
  3. 拡張機能をインストールしてから、研究リンクに戻り、ページを更新します。
  4. 研究が拡張機能がインストールされていることを確認したら、Startをクリックして開始します。

研究中

  • 通常通り、表示されているウェブサイトを使用して対話し、ブラウズし、クリックし、指示に従ってスクロールしてください。
  • 拡張機能はバックグラウンドで静かに作動します。対話する必要はありません。
  • 研究中に拡張機能アイコンをクリックしないでください — 必要ありません。

研究後

  • もし指示があれば、研究後の質問に答えてください。
  • 研究が終了したら、もう必要ない場合は拡張機能をアンインストールできます：
    • ツールバーの拡張機能アイコンを右クリック → 「Chromeから削除」。

Labvanced chrome拡張機能を削除する。

6. ユースケース

6.1 EコマースUX研究

商品リストやチェックアウトページを埋め込みます。参加者が注目する商品画像、クリックする「カートに追加」ボタン、意思決定をするまでにどれだけスクロールするかを追跡します。

Labvancedに埋め込まれた書店ウェブサイトの例

6.2 ニュースとメディア注目研究

ニュース記事やホームページを埋め込みます。どの見出しが最も注目を集めるか、記事の長さによる読書パターンの変化、どの画像が最初に目を引くかを測定します。

Labvancedに埋め込まれたニュースウェブサイトの例

6.3 ナビゲーションと情報アーキテクチャテスト

ウェブサイトのナビゲーションメニューやマルチページフローを埋め込みます。クリックやホバーの滞在時間を記録して、メニューラベルの明確さと見つけやすさを評価します。

6.4 比較研究（A/B）

異なるウェブサイトバージョンを埋め込んだ二つの試行を作成します。Labvancedの組み込みカウンターバランスを使用して、条件ごとに参加者をランダム化します。グループ間のAOIメトリックを比較します。

7. データとプライバシー

拡張機能はどのようなデータを収集しますか？

拡張機能は、アクティブなLabvanced研究セッション内にいる場合にのみ、次のデータを収集します：

  • 研究者が選択したページ要素のバウンディングボックス位置（x、y、幅、高さ）
  • マウス座標、クリック位置、ホバーイベントおよびマウスの移動経路
  • 現在のページスクロール位置とページURL
  • ホバー/クリックした要素からの表示テキストスニペット（50文字に切り捨て）

パスワードフィールドや機密性の高いフォーム入力は決して読み取られません。 拡張機能は、<input type="password">や機密のあるオートコンプリート属性（autocomplete="password"、cc-*）を明示的に除外します。これらはすべての場合において空の値を返します。

データはどこに送信されますか？

すべてのデータは、埋め込まれているlabvanced.comページにのみ、ブラウザのpostMessage APIを介して送信されます。拡張機能は外部サーバーにデータを送信せず、何もローカルに保存せず、Labvanced研究以外の通常のブラウジング中にデータを収集することはありません。

拡張機能は他のウェブサイトで私を追跡しますか？

いいえ。拡張機能のコンテンツスクリプトはすべてのiframeに注入されます（ターゲットウェブサイトのドメインは事前に未知であるため）が、location.ancestorOriginsがlabvanced.comが祖先フレームであることを確認しない限り、すぐに終了します。Labvancedによって埋め込まれていないウェブサイトでは、リスナーはインストールされず、DOMは読み取られず、データの流れはありません。

拡張機能はLabvanced以外のものを修正しますか？

いいえ。拡張機能は、labvanced.comのトップレベルURLを持つブラウザタブ内でだけ、iframe埋め込み制限（X-Frame-Options / Content-Security-Policyヘッダー）を解除します。他のすべてのタブには完全に影響を及ぼしません。これらのルールはメモリ内にのみ保存され、タブが閉じられるか移動されると削除されます。

完全なプライバシーポリシー

完全なプライバシーポリシーは次のURLで確認できます: https://www.labvanced.com/extension-privacy-policy.html

8. トラブルシューティング

ウェブサイトが私の研究に読み込まれない

可能性のある原因と修正：

症状可能性のある原因修正
真っ白のフレーム拡張機能がインストールされていないか無効chrome://extensionsで拡張機能が有効になっていることを確認してください。
ウェブサイトがインタラクティブでないまたは応答がないサイトがJSレベルでiframe埋め込みを検出している一部のサイトは埋め込むことができません — [email protected]に連絡してください。

拡張機能アイコンが警告を表示するか、灰色になっている

  • アイコンをクリックしてポップアップを開き、ステータスメッセージを確認します。
  • labvanced.comページにいるか、Labvanced研究が開いていることを確認してください。
  • chrome://extensionsから拡張機能を無効にして再度有効にしてみてください。

要素ピッカーが要素を強調表示しない

  • 拡張機能が有効であり、エディタにいることを確認してください（プレビューモードではありません）。
  • 一部のウェブサイトは、要素を選択制限するShadow DOMまたはiframe内のiframe構造を使用しています。Object Propertiesパネルを使用してParent要素を選択してみてください。
  • エディタを更新して再試行してください。

9. よくある質問

Q: 拡張機能は無料ですか？ A: はい。拡張機能は無料でインストールして使用できます。研究を設計するにはLabvancedアカウントが必要です。

Q: 他のブラウザ（Firefox、Safari、Edge）で動作しますか？ A: 現在サポートされているのはGoogle Chromeのみです。Microsoft Edge（Chromiumベース）は動作する可能性がありますが、公式にはサポートされていません。

Q: 研究の後も拡張機能をインストールしたままにする必要がありますか？ A: いいえ。参加者は研究が終了した後、すぐにアンインストールできます。拡張機能アイコンを右クリック → "Chromeから削除"。

Q: 拡張機能はブラウザを遅くしますか？ A: 拡張機能はLabvancedセッションの外では無効です。通常のブラウジングにオーバーヘッドを追加しません。

Q: 私のパスワードや銀行情報を見ることができますか？ A: いいえ。パスワードフィールド（<input type="password">）とクレジットカード入力は明示的に除外され、すべての場合において空の値を返します。拡張機能は機密性の高いフォームデータを読み取ったり送信したりすることはありません。

Q: 私は研究者です — 参加者が独自に訪れたウェブサイトを追跡するためにこれを使用できますか？ A: いいえ。拡張機能はlabvanced.comによって埋め込まれたiframe内でのみアクティブ化されます。参加者が他のタブで独立して訪れるウェブサイトを追跡することはできません。

Q: 私の機関のITポリシーによって、従業員が拡張機能をインストールする前にレビューが求められています。誰に連絡できますか？ A: 依頼内容を[email protected]にご連絡ください。

10. 連絡先とサポート

Email: [email protected]

ドキュメンテーション: https://www.labvanced.com/content/learn/ja/en/guide/

Discordのコミュニティフォーラム: https://discord.com/invite/SBpFJnVZah

バグ報告: 次の情報を含めてください：

  • Chromeのバージョン (chrome://settings/help)
  • 埋め込もうとしているウェブサイトのURL
  • エラーメッセージのスクリーンショット
  • 問題を再現する手順


Labvanced Web BridgeはScicovery GmbHによって開発および維持されています。完全なプライバシーポリシーについては、https://www.labvanced.com/extension-privacy-policy.htmlをご覧ください。