サブスタディオブジェクトを介してオンライン実験に埋め込まれたスタディやタスクを追加する。

サブスタディオブジェクト

Sub Study Objectは、単一の実験内に他のスタディを埋め込むために使用できます。本質的に、これらの「サブスタディ」を含む「親スタディ」が存在します。これらは他のLabvancedスタディです。

重要な用語: 「親スタディ」は、それにリンクされている「サブスタディ」または「子スタディ」を保持しています。


このオブジェクトの使用ケースは多数あり、新しいスタディのために毎回作成することなく、標準的な質問票や事前スクリーニングを組み込むことや、スタディ間で被験者のパフォーマンスを比較すること、テストバッテリーを確立することなどがあります。単にスタディを埋め込むことにより、時間を節約し、実験設計および管理プロセスを効率化できます。

Sub Study Objectを使った作業方法を説明しますので、質問がある場合はご連絡ください！

サブスタディオブジェクトのプロパティ

Sub Study Objectは、タスクエディターツールバーのVariousグループを開き、Sub Studyを選択することで、親スタディに追加できます。その後、右側のObject Propertiesパネルを使用してSub Study Objectの機能を制御できます。

スタディオブジェクトのExp_id

特定のスタディを埋め込むには、単にSub Study Objectを選択し、Object Propertiesパネルをスクロールダウンします。下部の「サブスタディ」という見出しの下に、Exp_idのフィールドがあります。これは、フォルダーアイコンを開く際に選択したスタディに基づいて自動的に入力されます。そこに表示される数値は、実験IDを示しています。

以下の例では、Exp_idは67935に等しいです。

埋め込まれたスタディの実験ID

サブスタディオブジェクトのリンク変数

親スタディにサブスタディを埋め込むと、Link variables +の緑色のアイコンをクリックすることで、そのスタディから現在のスタディに変数をリンクしたり「呼び出したり」することができます。

サブスタディオブジェクトの変数をリンクする。

選択できる利用可能な変数のリストが表示されます。選択すると、その変数は自動的に「LINKED VARIABLES」テーブルに追加されます。以下に示すように:

埋め込まれたスタディに関連するリンク変数。

Rec_Session_Id変数は記録セッションIDを指し、これは親スタディとサブスタディのセッション間でIDを一致させるために自動的に表示されます。

クエリパラメータ

サブスタディにおいて、親スタディから静的値を受け取るには、クエリパラメータを使用できます。

親スタディでSub Study Objectを選択し、Object PropertiesをスクロールダウンしてQuery Parametersフィールドにアクセスします。

以下の例では、&name=value文字列で定義された2つのパラメータを作成しています、

  • &participation_study= このパラメータには値「questionnaireB」が設定されました
  • &participation_points= このパラメータには値「15」が設定されました

埋め込まれたスタディからメインスタディに情報を送信するためのURLクエリパラメータの例。

クエリパラメータの作業に関する重要な注意事項:

  • パラメータ名は作成し割り当てるものですが、スタディ間で一貫性が必要です。
  • パラメータ名の後に割り当てる値も静的であり、親スタディでは一度だけの割り当てが可能です。
  • これらの値は自動的にURLに追加され、参加者には表示されません。

サブスタディがこれらの値を受け取り保存するためには、次のセクションで説明するようにイベントを使用する必要があります。

URLパラメータのイベント

サブスタディ自体、すなわち子スタディに入ると、親スタディから送信されたURLパラメータを介して保存された静的値を読み取るイベントを作成できます。

まず、このプロセスを開始するトリガーを指定します。その後、変数に値を保存するためのアクションを作成する必要があります：

  • Variable Actions → Get URL Parameter
  • アクション内で、以下を指定できます：
    • Parameter Name
    • Save in Variable

以下の例では、URLクエリパラメータを保存するために2つの変数を作成しました：

サブスタディオブジェクトを使用して埋め込まれたスタディでURLパラメータを読むアクション。

再度、Parameter Nameは親スタディでの記述と完全に一致させてください。一方、Save in Variableは任意の名前を付けることができます。

追加オプション

Object Propertiesパネルの下部では、Sub Study Objectの振る舞いに関する追加オプションが利用可能です：

サブスタディオブジェクトを介して埋め込まれたスタディを制御するための追加オプション。

トライアル初期化時の自動読み込み

このオプションは、トライアルの初期化時にサブスタディを自動的に読み込むことを指定します。自動的にサブスタディを読み込みたくない場合は、このオプションのチェックを外し、イベントを使用していつ読み込むか、およびオブジェクトの振る舞いを指定します。

サブスタディコントロールの表示

Sub Study Controlsは、オブジェクトの左下隅に存在するコントロールボタン（「リロード」ボタンなど）を指します。

サブスタディオブジェクトからのデータと記録

実験中に収集されたデータは、それぞれのサブスタディのData View & Export Tab.内に表示されます。

Labvancedでサブスタディオブジェクトを使用して埋め込まれたスタディのデータ。