
Send PostMessage Action
Send PostMessageアクションは、実行中のLabvanced実験から親ウェブページ、カスタムアプリケーション、または埋め込みフレームなどの外部ターゲットにブラウザのpostMessage APIを使用してメッセージを送信します。
概要
このアクションはアクション選択メニューのAPI Actionsにリストされています。

一般的な使用例
- 参加者が特定のポイントに達したり、タスクを完了した際に親アプリケーション(例:LMSや学内ポータル)に通知する。
- スコア、応答、または条件ラベルなどの変数値をリアルタイムで外部システムに渡す。
二方向のセットアップ
Labvancedと外部ページ(iFrameや親アプリケーションなど)間でpostMessageを使用することは、二方向のプロセスです。Labvancedは片側を処理します:このアクションはメッセージを送信します。もう片方は外部ページで、メッセージを受信するようにプログラムされている必要があります。
postMessage APIは標準のブラウザ機能です。外部ページには、Labvancedからのメッセージを受け取るためのwindow.addEventListener('message', handler)リスナーが必要です。そのリスナーはドメインでフィルタリングし、メッセージの送信元がLabvancedであることを確認して、信頼できるソースからのメッセージにのみ反応するようにします。必要であれば、あなたまたはあなたの開発者がそのコードを書く必要があります。AIコーディングツールを使用すれば、迅速に生成することができます。
動作原理
このアクションが発火すると、LabvancedはターゲットウィンドウにpostMessageを送信します。メッセージは、Destination Domainでリスニングしている任意のページに配信されます。
メッセージのペイロードにはValue to sendが含まれています。Keyが設定されている場合は、ペイロードに含まれ、受信側がメッセージタイプを識別し、それに応じて処理できるようになります。
外部ページはメッセージの処理を担当します。そのリスナーは、Labvancedから送信されたメッセージにのみ応答するために、メッセージの送信元を確認するべきです。
Send PostMessageを選択すると、次の設定が表示されます:

アクションのオプション
| メニュー項目 | Send PostMessageアクションオプション |
|---|---|
Destination Domain | メッセージを受信すべきターゲットオリジンを指定します。デフォルト値は*で、任意のオリジンに送信されます。送信先が既知の場合は*を完全なターゲットURL(例:https://yoursite.com)に置き換えます。セキュリティのために正確なドメインを指定することを推奨します。 |
Key | 発信するメッセージに識別キーを付加します。これによりメッセージペイロードがKey: valueとして構成され、受信側が異なる種類のメッセージを区別できるようになります。キーが不要な場合は空のままにします。 |
Value to send | 発信するメッセージに含めるデータを定義します。編集アイコンをクリックしてValue-Select Menuを開き、送信する内容(定数値、Labvanced変数、または式)を指定します。 |
**注意:**メッセージを受信するシステム(親ページまたは外部アプリケーション)は、Labvancedからの着信postMessageを処理するためにwindow.addEventListener('message', ...)リスナーを実装する必要があります。