2026年10月1日·Minds Team

Adobe GenStudio向けMinds: 開発ガイド

計画中のメールコピーレビュー拡張機能、Adobeのエンタイトルメント要件、明示的なエクスペリエンス選択、Mindsリサーチドラフト、およびネイティブホストのリリースゲートについて解説します。

Mindsオーディエンスレビュー拡張機能は、Adobe GenStudio for Performance Marketing向けの開発パッケージです。初期実装では、1つのメールエクスペリエンスを選択し、そのテキストフィールドからリサーチ入力を準備します。このパッケージはビルド済みですが、ネイティブのGenStudio環境にはインストールされておらず、受け入れテストも完了していません。また、一般公開されているAdobe Exchangeの掲載項目ではありません。

Mindsは商用シンセティックリサーチのためのエンドツーエンドプラットフォームであり、AudiencesとStudiesを通じて定性調査と定量調査をつなぎます。本アダプターはそのワークフローへの限定的なエントリーポイントです。メールコピーに絞られたスコープと開発上の制限は、より広範なMindsリサーチプラットフォーム全体の制限を意味するものではありません。

ステータスとエンタイトルメントのブロッカー

ステータス確認日: 2026-10-01。Adobe開発者アカウントおよびMinds Creative Reviewコンソールプロジェクトは存在します。現在の組織では「Add to Project」でRuntimeが無効化されており、このアカウントでは必要なApp Builder / GenStudioのエンタイトルメントが付与されていませんでした。

Adobeアカウントや空のConsoleプロジェクトが存在するだけでは、製品へのアクセス権は得られません。デプロイ、拡張機能の登録、および実際のホスト環境でのテストを行うには、適切にエンタイトルメントが付与された組織とプロジェクト/ワークスペースが不可欠です。開発者プロジェクトが存在するという理由だけで、コンパイルされたバンドルを「インストール済み」と表現しないでください。

要件とオーナーシップ

App BuilderおよびGenStudioへのアクセス権と、拡張機能の登録権限を持つ対象のAdobe組織を使用してください。Adobeのサポート対象組織プロセスを通じて、必要なプロジェクト/ワークスペースを取得します。また、Mindsアカウントと、リサーチの目的に一致するAudienceを含む既存のStudyが必要です。

Adobe開発者のオーナーシップとMindsリサーチのオーナーシップは分離されています。プロジェクト設定を変更する前に組織を確認し、Studyを選択する前にMindsアカウントを確認してください。プロバイダークレデンシャル、ランタイムキー、プライベートリンク、およびプライベートリサーチペイロードは、ドキュメントやスクリーンショットに含めないでください。

拡張機能のセットアップに関するAdobeのリファレンスはGenStudio Extensibility Guideを参照してください。Expressの開発者アクセスではGenStudioのエンタイトルメントは確立されません。エンタイトルメントを持つ組織のサポート対象デプロイパスを使用してください。

パッケージの実装内容

本パッケージは、検証拡張機能およびメールチャネル向けのMindsオーディエンスレビューエントリーを登録します。そのレビュービューはホストにアタッチされ、エクスペリエンスをロードし、明示的な選択を要求します。単一エクスペリエンスのレビューでは、生成されたすべてのバリアントを勝手にエクスポートすることはありません。

素材または決定事項	初期パッケージの挙動
選択された1つのメールエクスペリエンス	指定されたテキストフィールドを読み取り、正確なコピーのリサーチ入力を準備。
生成された複数のバリアント	ユーザーに1つの選択を要求。自動的な一括転送は行わない。
画像およびビジュアルレイアウト	本アダプターではエクスポートも評価も行わない。
法的または規制へのコンプライアンス	認証やコンプライアンスの保証は提供しない。

拡張機能はホストの検証エントリーポイントで実行されます。オーディエンスフィードバックをコンプライアンス認証、キャンペーン公開の承認、またはブランドポリシーの決定に変換することはありません。

メールコピーの選択と承認

エンタイトルメントが付与された環境へのデプロイと登録が完了したら、検証エリアからMindsレビュービューを開き、メールエクスペリエンスを生成します。「Select material to review」を使用して対象のエクスペリエンスを選択し、素材が誤っている場合やホスト内にとどめるべき場合はキャンセルします。

アダプターはそのエクスペリエンスの指定フィールドをラベル付きテキストに変換し、コピーを入力としてそのまま保持します。HTMLのレンダリング、ビジュアルレイアウトのキャプチャ、メール画像の書き出しは行いません。メッセージの明瞭さ、関連性、信頼性、次のステップの解釈など、テキストから回答可能な問いを設定してください。

選択されたラベルを確認し、対象のStudyを選択して、ドラフト作成前に転送を承認します。1つのエクスペリエンスを選択しても、すべてのバリアントを送信する許可にはなりません。素材転送への同意はリサーチを実行するものではありません。実際のホスト環境で選択、キャンセル、フィールドの正確性を確認するまでは、テスト済みとみなさないでください。

想定されるMinds認証とドラフトフロー

共有パネルからブラウザネイティブのMinds OAuthが開きます。接続を承認してGenStudioに戻り、「Refresh Studies」を実行して、Audienceが設定された既存のStudyを選択します。具体的なリサーチリクエストを入力し、Studyの言語を選択します。開発パネルでは限定されたStudyリストが使用されるため、リストにない項目がある場合はアカウントとリストのスコープを確認する必要があります。

「Draft research plan」を実行すると、選択された正確なテキストがプロンプトソースとして正規のStudyプレビュー操作に送信されます。保存されたレスポンスの目的、言語、設問、ソースを検査し、選択したエクスペリエンスが正しく参照されていることを確認してください。現在のパネル内で変更されていない入力を再試行する場合は、冪等性識別子が再利用されます。

Minds上で保存されたドラフトをそのまま開き、素材、設問、Audience、使用量を確認した上で、リサーチを明示的に確定します。そのドラフトの完了した実行結果からのみ所見を取得します。プロバイダー登録と公開マーケットプレイスの承認は、引き続き個別のゲートとして管理されます。

調査結果とエビデンスの境界

共有パネルは、選択されたドラフトの完了したリサーチ実行から所見をリクエストします。本アダプターは所見の書き戻しを実装していません。想定される初期ワークフローでは集約された所見を表示し、ユーザーがメールコピーの修正方法を判断できるようにします。ホスト環境でテスト済みと表現する前に、GenStudio内で動作を確認してください。

シンセティックオーディエンスのフィードバックは、スコープが限定された方向性を示すエビデンスです。コピーの方向性探索を支援することはできますが、人間による観察、代表性のある推計、法的な承認、規制上のエビデンスを確立するものではありません。意思決定において必要な場合は、専門家や人間による検証を実施してください。生成されたサマリーのない保存済みプレビューは、リサーチ結果ではありません。

保存されたプランのレビュー、確認、実行

保存されたドラフトのワークフローでは、Minds内で正確なリサーチプランが開かれます。ゲートウェイおよびプライベートのZapier 1.2.0パッケージは、そのドラフトに紐づく完了済みの所見を返します。レビューと実行はMinds内で行われます。公開マーケットプレイスでの利用可否は、各プロバイダーの登録および承認状況に依存します。以下の手順に従ってください:

パネルから「Open Study in Minds」を選択するか、Zapierから返されたReview URLを開きます。ドラフトを作成したアカウントにサインインします。
インポートされたソース、リサーチ目的、言語、すべての設問、選択されたAudienceを検査します。素材と対象母集団が下そうとしている意思決定に合致していることを確認します。
不足している入力や明確化のための質問に回答し、修正したプランを保存します。更新された設問を再度確認します。確認はその特定のリビジョンに対して適用されます。
手法が見積もりに対応している場合は、利用可能な回答枠と推定使用量を確認します。実行中に追加の設問を生成する手法では、誤った固定合計値は提示されません。Audienceの不足、母集団の空状態、アカウント制限がある場合は、確認前に解決してください。
明示的なリサーチ確認チェックボックスをオンにします。プランが高度な手法を使用している場合は、個別のオプトインを確認して同意します。「Confirm and run」を一度だけ選択します。リンクを開く、素材をインポートする、プランをプレビューする操作だけでは、リサーチは実行されません。
この実行のステータス（キュー待ち、実行中、完了、失敗）を確認します。同じドラフトを再読み込みすると、別の実行が作成されるのではなく、確認済みの実行が再開されます。確認前の場合、再読み込みには新たな同意が必要です。エラーが発生した場合でも、検査と再試行のために保存されたドラフトは保持されます。
元のパネルに戻って「Load findings」を選択するか、Zapierの「Get Completed Research Results」検索を保存済みのStudy IDおよびDraft Plan IDとともに使用します。このドラフトの確認済み実行から得られた完了結果のみが返されます。未完了、失敗、存在しない実行の場合に、過去の古いStudyサマリーへとフォールバックすることはありません。

リサーチの実行中は元のパネルを開いたままにしてください。短期間の接続およびドラフト選択はメモリ上に保持されます。ホストパネルを再読み込みしたり再接続したりすると、素材の選択とドラフト作成を再度行う必要がある場合があります。保存されたドラフトと確認済みの実行は、パネルセッションが終了してもMinds内に残ります。保持された結果を確認するには、MindsのStudyに戻ってください。

権限、データ、セッション

拡張機能はAdobeのSDKを通じて選択されたエクスペリエンスを読み取り、明示的に承認された素材をMindsゲートウェイ経由で送信します。OAuthトークンはゲートウェイ内に保持され、パネルはメモリ上に有効期間の短い不透明なケーパビリティを保持します。パイロットセッションは1時間で期限切れとなり、ゲートウェイが再起動した場合は再接続が必要になります。

テストエクスペリエンスには不要な個人情報を含めないようにしてください。切断操作によってゲートウェイへのアクセス権は削除されますが、Studyドラフトとともにすでに保存されたテキストは削除されません。保持された素材は、MindsプライバシーポリシーおよびAdobe組織の管理ポリシーに従って管理してください。

トラブルシューティングと受け入れ基準

事象	意味と次のステップ
ConsoleでRuntimeが無効になっている	必要な組織エンタイトルメントが不足しています。別の空プロジェクトを作成しても解決しません。
拡張機能が表示されない	エンタイトルメントを持つデプロイ、登録、および選択されたワークスペースを確認してください。
利用可能なエクスペリエンスがない	素材を選択する前に、メールエクスペリエンスを生成してください。
設問がレイアウトに依存している	本パッケージはテキストのみを読み取ります。Mindsでサポートされているビジュアル入力を使用してください。
ゲートウェイがオリジンを拒否する	GenStudioの正確なホストオリジンが承認および有効化されていません。
ハンドオフ経由でドラフトを実行できない	一致するフロントエンドリリースと作成者アカウントを確認してください。ネイティブGenStudioでの受け入れはエンタイトルメントによりブロックされたままです。

受け入れ基準には、実際の登録、エクスペリエンスの選択/キャンセル、正確なコピーへの同意、OAuthライフサイクル、ソースの正確性、再試行の挙動、サポートされたコスト/確認/実行、サマリーの非存在、有効期限、プロバイダーレビューが含まれている必要があります。エンタイトルメント環境でのホストテストが完了していないため、稼働中のGenStudioのスクリーンショットは提供されていません。