
PostMessage 受信トリガー
PostMessage Received トリガーは、実行中の Labvanced 実験がブラウザの postMessage API を介して外部ソースからの受信メッセージを取得したときに発火します。これを使用して、あなたの研究を親ウェブページ、カスタムアプリケーション、または実験に直接データを送信する埋め込まれた外部ウェブサイトに接続できます。
概要
PostMessage Received トリガーは、トリガー選択メニューの API/External Trigger の下にリストされています。

一般的な使用例
- 埋め込まれたウェブサイトがユーザーのインタラクションイベント(クリック、フォームの完了)を構造化された postMessages として Labvanced に転送する。
- 親アプリケーション(例:カスタム LMS や機関のウェブポータル)が実験を進めたり参加者データを渡すためにメッセージを送信する。
- 外部スクリプトが実験ロジックの特定のポイントをトリガーする JavaScript ドリブンの統合。
二方面のセットアップ
Labvanced と外部ページ(iFrame や親アプリケーションなど)との間で postMessage を使用することは、二方面のプロセスです。Labvanced は片方を処理します:このトリガーは受信メッセージを待ち受けます。もう片方は外部ページであり、そこはメッセージを送信するようプログラムされている必要があります。
postMessage API は標準のブラウザ機能です。外部ページは window.parent.postMessage(data, targetOrigin) を呼び出してデータを Labvanced に送信します。あなたまたはあなたの開発者がそのコードを書く必要があります。AI コーディングツールもその設定を手助けすることができ、コンテキストを与えることで迅速に生成できます。
一般的なパターンは、外部ページが自分のユーザーイベント(クリック、フォーム提出、サインアップなど)を待ち受け、各イベントを Labvanced に対する postMessage として転送することです。各イベントタイプは、click_event、signup_event などのラベルでタグ付けすることができ、Labvanced はそれぞれを個別にフィルタリングし、応答することができます。
動作原理
実験が実行中のとき、Labvanced は受信 postMessage を待ち受けます。メッセージが到着するたびに、次の二つを確認します:
- オリジンドメイン:このメッセージは許可されたソースから来ているか?
- キー:このメッセージは期待されるキー値を持っているか(設定されている場合)?
両方の条件を満たす場合、トリガーが発火し、メッセージのペイロードがあなたのアクションで Message Content として利用可能になります。
外部ページはメッセージを送信する責任があります。それは独自のコードで window.parent.postMessage(data, targetOrigin) を呼び出すことで行います。送信される data は何でもかまいません:プレーンな文字列、構造化値、またはイベントラベルです。Labvanced の Key フィールドは、そのラベルの特定の値をマッチさせて、異なるタイプのメッセージを区別する方法です。
各メッセージタイプは Labvanced において独自のイベントを持つことができます。例えば、あるイベントは外部ページがクリックを報告した際に Key: click_event を使用して発火し、別のイベントはフォーム提出を報告する際に Key: signup_event を使用して発火します。
PostMessage Received を選択すると、次のダイアログが表示されます:

トリガーオプション
| メニュー項目 | PostMessage 受信トリガーオプション |
|---|---|
Origin Domain | このトリガーにメッセージを送信することが許可されたドメインを指定します。デフォルト値は * で、任意のオリジンからのメッセージを受け入れます。特定のソースにトリガーを制限するには、* を完全なオリジン URL(例:https://yoursite.com)に置き換えてください。送信元が知られている場合は推奨されます。 |
Key | このトリガーが一致させたい特定のキー値を入力します(例:click_event、signup_event)。受信メッセージがその正確なキー値を持つ場合のみトリガーが発火します。フィールドを空のままにすると、内容に関係なく任意の受信メッセージで発火します。 |
注:受信メッセージ値はメッセージ内容としてエクスポートされ、値選択メニューを介してアクションで参照できます。
PostMessage 受信のトリガー特有の値
PostMessage Received トリガーを選択した後、次のトリガー特有の値をその後のアクションで Value-Select Menuを介して参照できます。
| 値 | 説明 |
|---|---|
Message Content | 受信した postMessage のデータペイロード。これは外部ソースによって送信された値で、変数に保存したり、ロジックを駆動させたり、データセットの一部として記録したりできます。 |
Trigger Timestamp (Unixtime) | トリガーが発火した時刻の Unix 時間。 |
Trigger Time (From Frame Onset) | 現在のフレームの開始からトリガーが発火するまでのミリ秒数。 |