> For the complete documentation index, see [llms.txt](https://docs.immedio.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.immedio.io/immedio-box/questionnaires/index.md).

# アンケート管理

資料閲覧者から情報を取得するアンケートを作成・管理する画面です。

資料閲覧者から追加情報を取得するためのアンケートを作成し、コンテンツやルームに紐づけて表示できます。回答結果はリード情報として蓄積され、Salesforce・HubSpot への転送や immedio ルーターへの引き渡しにも活用できます。

## アンケート管理でできること

| 機能             | 説明                                                                   |
| -------------- | -------------------------------------------------------------------- |
| アンケートの管理       | アンケート（質問文と複数のアンケート項目の集合）を作成・編集・削除する                                  |
| アンケート項目の管理     | ラジオボタン・チェックリスト・プルダウン・1行テキスト・複数行テキストなど、個別の質問項目を作成・編集・削除する             |
| 非表示項目の設定       | 公開URL上には表示せず、裏側で値だけを保持する項目を作成する                                      |
| コンテンツ・ルームへの紐付け | 作成したアンケートを資料・動画・ルームに設定し、閲覧中に表示する                                     |
| CRMプロパティマッピング  | アンケート項目ごとに Salesforce・HubSpot 側のマッピング先プロパティを設定する                     |
| 公開URLでの動的な値渡し  | 公開URLのクエリパラメータ（`qi_識別子`）でアンケート項目のデフォルト値を動的に指定する                      |
| immedio ルーター連携 | アンケートに immedio ルーターAPI Key を設定し、回答内容を immedio ルーターに引き渡してルーター側の分岐に載せる |
| アンケート回答結果の確認   | リード詳細画面から、セッションごとの回答内容を確認する。CSVダウンロードにも含まれる                          |
| アンケート回答時の通知    | ワークフローで「アンケート回答完了」を発火条件にし、メール・Slack に通知する                            |

## アンケートとアンケート項目の関係

アンケート管理画面は「アンケート」と「アンケート項目」の 2 階層で構成されます。

* **アンケート項目**: 個々の質問（例: 「役職」「導入時期」「興味のあるサービス」）。項目単位で作成・再利用できます。
* **アンケート**: 質問文と、表示するアンケート項目の集合をまとめたもの。コンテンツ・ルームにはアンケート単位で紐づけます。

同じアンケート項目を複数のアンケートで使い回すことができます。

## アンケート項目の作成 <a href="#questionnaire-item" id="questionnaire-item"></a>

管理画面の「アンケート管理」から、項目設定で「新規作成」をクリックします。設定できる内容は次の通りです。

| 項目名       | 詳細                                         |
| --------- | ------------------------------------------ |
| 質問内容      | リードに表示する質問文                                |
| 識別子       | CRMプロパティマッピングや公開URLのクエリパラメータで使用するキー        |
| 質問タイプ     | 1行テキスト・複数行テキスト・ラジオボタン・チェックリスト・プルダウンから選択    |
| プレースホルダー  | テキスト欄のプレースホルダーに表示する文言                      |
| デフォルトテキスト | テキスト欄にあらかじめ表示するデフォルト値                      |
| 選択肢       | ラジオボタン・チェックリスト・プルダウン用の選択肢                  |
| 非表示にする    | 公開URL上には表示せず、デフォルト値やクエリパラメータの値だけを回答として保持する |

### 質問タイプ

| タイプ     | 用途                   |
| ------- | -------------------- |
| 1行テキスト  | 短い自由入力（役職、部署など）      |
| 複数行テキスト | 長文の自由入力（質問・要望など）     |
| ラジオボタン  | 選択肢から1つを選ぶ           |
| チェックリスト | 選択肢から複数を選ぶ           |
| プルダウン   | 選択肢から1つを選ぶ（プルダウン UI） |

ラジオボタン・チェックリスト・プルダウンでは、選択肢に加えて「その他」の自由入力欄を有効化することもできます。

### 識別子

アンケート項目には**識別子**を設定します。識別子は次の 3 つの用途で使われます。

* CRMプロパティマッピング時に、どの項目がどの CRM プロパティに対応するかを一意に特定する
* 公開URLのクエリパラメータで値を渡すときのキーになる（後述の [公開URLでのアンケート項目への動的な値渡し](#dynamic-query-params) を参照）
* immedio ルーター連携時に、immedio 側のプロパティ名と突合するキーになる

識別子は**テナント内で一意**で、同じ識別子を持つ項目を複数作成することはできません。CRM プロパティ名や URL クエリパラメータのキーとして使うため、英数字とアンダースコアだけで構成することを推奨します。

### 非表示項目

アンケート項目には「非表示にする」オプションがあります。非表示項目は次のように動作します。

* 公開URLのアンケートフォームには表示されない
* 公開URLのクエリパラメータ（`qi_識別子`）で渡された値、またはアンケート項目に設定したデフォルト値が、そのまま回答として送信される
* リード判別や流入元記録、Salesforce・HubSpot への値の引き継ぎに活用できる
* 非表示項目は「必須」に設定できません（表示されない項目を必須にすると回答不能になるため、常に任意扱いになります）

## アンケートの作成

項目を作成したら、アンケート設定で「新規作成」をクリックします。設定できる内容は次の通りです。

| 項目名                 | 詳細                                              |
| ------------------- | ----------------------------------------------- |
| 名前                  | 内部管理用の名称（テナント内で一意）                              |
| 質問文                 | リードに表示する質問文                                     |
| 項目                  | 事前に作成した項目から選択し、並び順・必須か否かを設定。同じ項目を複数回登録することはできない |
| immedio ルーターAPI Key | immedio ルーターへ回答を連携する場合に設定（後述）                   |

**削除の制約**: コンテンツ・ルーム・コンテンツテンプレート・ワークフローに紐づいているアンケートは削除できません。先に紐付けを解除してから削除してください。

**権限**: アンケートおよびアンケート項目の作成・編集・削除は**オーナー権限を持つユーザーのみ**が実行できます。

## アンケートのコンテンツ・ルームへの紐付け

作成したアンケートは、大きく分けて 2 つの使い方があります。

| 使い方             | 用途                                  | 想定シーン                                |
| --------------- | ----------------------------------- | ------------------------------------ |
| アンケート単体で表示する    | ファイル閲覧中・後半で表示し、感想やフォローアップ希望を確認する    | 資料や動画の感想を回収し、フォローアップ戦略を組み立てる         |
| メールアドレス確認時に表示する | ファイルを本格的に閲覧させる前に、フォローアップに必要な情報を取得する | アウトバウンド・掘り起こしなど、情報が限定的な顧客から基本情報を取得する |

### 資料内でアンケートを表示する（ワークフロー経由）

各資料の「外部連携」タブから「新規作成」をクリックして、ワークフローとしてアンケートを設定します。ワークフロー経由でのアンケート表示に対応しているのは **PDF と動画のみ**で、発火トリガーはコンテンツ種別によって異なります。

| コンテンツ種別      | 使えるトリガー                   |
| ------------ | ------------------------- |
| PDF          | ページ到達 / ページ滞在             |
| 動画           | 秒数到達 / 総再生秒数到達            |
| ドキュメント / URL | 非対応（ワークフローからアンケートを表示できない） |

ドキュメント・URL・ルームで閲覧前にアンケートを取りたい場合は、[閲覧制限アンケート](#access-control-questionnaire) を利用してください。

ワークフローでアンケートを表示する際、**回答必須**の設定を ON にできます。ON にすると閲覧者はアンケートに回答するまでダイアログを閉じられなくなり、続きの閲覧に進めません。OFF (任意回答) の場合は、ダイアログ右上の × ボタンまたは ESC キーで閉じて閲覧を続けられます。

### メールアドレス認証時にアンケートを表示する（閲覧制限アンケート） <a href="#access-control-questionnaire" id="access-control-questionnaire"></a>

コンテンツ・ルームの**閲覧制限**設定でも作成済みのアンケートを紐づけて表示できます。閲覧制限に達したタイミングでアンケート画面が表示され、回答するとファイルの続きが閲覧できるようになります。

詳しい設定方法は各閲覧制限のドキュメントを参照してください。

* [コンテンツの閲覧制限（アンケート）](/immedio-box/contents/detail/access-controls.md#questionnaire)
* [ルームの閲覧制限（アンケート）](/immedio-box/rooms/detail/access-controls.md#questionnaire)

### 1 セッション 1 回答

**1 セッションにつき、1 コンテンツ（または 1 ルーム）で保持されるアンケート回答は 1 件のみ**です。同じ閲覧者が同じコンテンツに対して再度アンケートに回答すると、既存の回答が新しい回答で上書き（更新）されます。回答が 2 件並列で残ることはありません。

## CRMプロパティマッピング <a href="#crm-property-mapping" id="crm-property-mapping"></a>

アンケート項目単位で、Salesforce（Lead・Contact・Account）または HubSpot（Contact）のマッピング先プロパティを設定できます。回答が送信されると、指定した CRM プロパティに値が転送されます。

### 前提

Salesforce または HubSpot との連携が事前に完了している必要があります。連携がまだの場合は先に [Salesforce連携](/immedio-box/guides/integrations/salesforce.md) / [HubSpot連携](https://github.com/immedioinc/immedio-docs/tree/main/immedio-box/guides/integrations/hubspot.md) を行ってください。

### 設定手順

1. アンケート管理で、CRM に連携したいアンケート項目を選択する
2. 項目編集画面下部で、連携する CRM を選ぶ
3. CRM 側の連携先プロパティを設定する
   * Salesforce の場合は「リード」「取引先責任者」「取引先」でそれぞれマッピングを設定できる。
   * HubSpot の場合は「コンタクト」プロパティを設定する
4. **上書きポリシー**を選択する（後述）
5. ファイル側の「ワークフロー」で、トリガー「アンケート回答完了」・実行処理「Salesforce プロパティ更新」「Salesforce 取引先プロパティ更新」または「HubSpot プロパティ更新」を設定する

ここまで設定すると、アンケート回答時（閲覧制限アンケートを含む）に CRM に情報が連携されます。

### 取引先プロパティ更新時の注意

Salesforce の「取引先」オブジェクトにはメールアドレス項目がないため、対象の取引先は**回答者のメールアドレスに紐づく取引先責任者を経由して特定**されます。該当する取引先責任者が存在しない、またはその取引先責任者に取引先が紐づいていない場合、取引先プロパティは更新されません（リードのように新規レコードが自動作成されることもありません）。

### マッピング対象にできるCRMプロパティの制限 <a href="#questionnaire-crm-mapping" id="questionnaire-crm-mapping"></a>

アンケート回答はすべて文字列として送信されるため、マッピング先として選べるのは次の型の項目だけです。マッピング画面のプロパティ一覧にも対象の項目だけが表示されます。

| CRM        | マッピング先として選べる項目の型                               |
| ---------- | ---------------------------------------------- |
| Salesforce | テキスト、テキストエリア、電話、URL、選択リスト、選択リスト（複数選択）          |
| HubSpot    | 単行テキスト、複数行テキスト、電話番号、ドロップダウン（単一選択）、ラジオボタン（単一選択） |

メールアドレス形式の項目、参照のみ・自動計算の項目は対象外です。Salesforce の「メール」項目と HubSpot の「email」プロパティも、回答者とレコードの紐づけに使用しているため対象外です。

### 選択リスト（複数選択）への連携

Salesforce の「選択リスト（複数選択）」には、アンケートの**チェックリスト**項目をマッピングします。複数の選択肢が選ばれた場合、Salesforce 側でも複数の値として登録されます。

* チェックリストの選択肢に `,`（カンマ）と `;`（セミコロン）は使用できません。1つの選択肢が複数の値として扱われてしまうためです
* Salesforce 側で「値セットで定義された値に選択リストを制限します」が有効な場合は、アンケートの選択肢と Salesforce の選択肢の文言を一致させてください。一致しない値は連携に失敗します（「その他」の自由入力も同様です）
* テキストの項目にマッピングしている場合も、チェックリストの回答はセミコロン区切りで送信されます（例: `A;B`）

### 上書きポリシー

CRM 側に既に値がある場合の挙動を項目単位で選択できます。

| 選択肢                    | 挙動                              |
| ---------------------- | ------------------------------- |
| 上書きしない                 | CRM 側のプロパティが空のときだけ書き込む。既存値は保持する |
| 上書きする（アンケート結果が空白でない場合） | アンケート回答が空でないときだけ、CRM 側を上書きする    |
| 上書きする                  | 常に CRM 側を上書きする                  |

### 回答が空欄のときの挙動

上書きポリシーで「上書きする」を選んでいる場合、アンケート回答が空欄のままでも「空の値」として連携されます。ただし次の項目はSalesforce側で必須とされている標準項目のため、空の値をそのまま書き込むことができません。

| Salesforce オブジェクト | 空にできない標準項目               |
| ----------------- | ------------------------ |
| リード               | 姓（LastName）／会社名（Company） |
| 取引先責任者            | 姓（LastName）              |
| 取引先               | 取引先名（Name）               |

これらの項目にマッピングしたアンケート項目が空欄で回答された場合、Box は次のように動作します。

| ケース                          | 挙動                                                                                  |
| ---------------------------- | ----------------------------------------------------------------------------------- |
| リードを**新規作成**するとき             | 空欄の必須標準項目には、**回答者のメールアドレス**が代わりに設定されます                                              |
| 既存のリード・取引先責任者・取引先を**更新**するとき | 空欄の必須標準項目は**更新対象から除外**され、Salesforce 側の既存の値がそのまま維持されます。同時にマッピングされている他の項目は通常どおり更新されます |

既存レコードの更新時にメールアドレスで補完すると、正しく登録されている会社名や氏名がメールアドレスで上書きされてしまうため、更新時は「書き込まない」動作になっています。

なお、取引先責任者・取引先はアンケート回答をきっかけに新規作成されることはありません（新規作成の対象はリードのみです）。

## 公開URLでのアンケート項目への動的な値渡し <a href="#dynamic-query-params" id="dynamic-query-params"></a>

公開URLのクエリパラメータで、アンケート項目のデフォルト値を動的に指定できます。同じ資料URLを複数の配信経路（メルマガ・キャンペーン・広告など）で使い回している場合に、流入元をアンケート回答として記録するといった使い方が可能です。

### 使い方

アンケート項目の**識別子**の先頭に `qi_` を付けたものをクエリパラメータのキーとして URL に付与します。

* 識別子が `source` の場合 → `qi_source`
* 識別子が `campaign` の場合 → `qi_campaign`

**例:**

```
https://box.immedio.io/p/test/U1x3fh?qi_source=HOGEHOGE
```

上記URLで公開ページを開くと、識別子 `source` のアンケート項目のデフォルト値に `HOGEHOGE` がセットされた状態でアンケートが表示されます。

### 複数値の受け渡し（チェックリスト）

チェックリストのように複数の値を持てる項目では、同じキーを繰り返して指定します。

```
?qi_interests=A&qi_interests=B&qi_interests=C
```

### 非表示項目との組み合わせ

「非表示項目」と組み合わせると、閲覧者からは見えない項目にだけ動的に値を渡すことができます。この場合、閲覧者は通常通り表示された項目だけを回答し、非表示項目にはクエリパラメータの値がそのまま記録されます。

### 活用例: 非表示項目 + CRMプロパティマッピングで流入元を CRM に自動記録

「非表示項目」と「CRMプロパティマッピング」を組み合わせると、閲覧者に何も入力させることなく、配信経路ごとの流入情報を Salesforce / HubSpot の特定プロパティに自動連携できます。

**シナリオ:** 同じ資料URLを複数のメルマガ配信で使い回しているが、どの配信で獲得したリードなのかを Salesforce の「リードソース詳細」プロパティに記録したい。

**設定:**

1. アンケート項目を作成する
   * 識別子: `lead_source_detail`
   * 質問タイプ: 1行テキスト
   * 「非表示にする」を ON
2. その項目の CRMプロパティマッピングで、Salesforce Lead の「リードソース詳細」プロパティを選択し、上書きポリシーを「上書きする（アンケート結果が空白でない場合）」にする
3. 資料側のワークフローで、トリガー「アンケート回答完了」・実行処理「Salesforce プロパティ更新」を設定する
4. メルマガ配信ごとに URL を出し分ける
   * 4月配信: `https://box.immedio.io/p/tenant/xxx?qi_lead_source_detail=mailmagazine_2026_04`
   * 5月配信: `https://box.immedio.io/p/tenant/xxx?qi_lead_source_detail=mailmagazine_2026_05`

**結果:**

閲覧者は非表示項目の存在を意識せずアンケートに回答でき、Salesforce 側には配信ごとに異なる値が「リードソース詳細」プロパティに書き込まれます。何のフォームも書かせずに配信経路の情報を CRM 側で分析できるようになります。

同様の仕組みで、キャンペーン ID・広告経由の UTM 相当・営業担当者コードなどを非表示項目 + qi\_ 経由で CRM に連携できます。

### 反映されないケース

次の場合、クエリパラメータの値は反映されず、そのアンケート項目のデフォルト値も設定されません（他の項目には影響しません）。

* クエリパラメータのキーが存在しない識別子を指しているとき
* ラジオボタン・チェックリスト・プルダウンなど選択肢のある項目で、選択肢に存在しない値を渡したとき（例: 選択肢が A・B・C の項目に `D` を渡す）
* 1つの値しか持てない項目（1行テキスト・複数行テキスト・ラジオボタン・プルダウン）に、同じキーを複数回付けて複数値を渡したとき
* 値がすべて空白のとき

## immedio ルーター連携

アンケート単位で **immedio ルーターAPI Key** を設定できます。API Key を設定しておくと、閲覧者がアンケートに回答したタイミングでアンケートの回答内容が immedio ルーターに引き渡され、ルーター側の分岐設定に基づいて後続のアクション（日程調整画面の表示・遷移・ルーター側の通知やマッピング処理など）が実行されます。**アンケート回答後に何を出すか・どこに振り分けるかは immedio ルーター側の設定で決まる**ため、日程調整に限らず柔軟に組み立てられます。

Box の公開URLだけでなく、資料を 埋め込みタグ や iframe で外部サイトに埋め込んでいる場合でも、同じ仕組みで immedio ルーターへ連携されます。

### 設定手順

1. **アンケートを作成する** アンケート項目の**識別子**は、immedio 側で使うプロパティ名と揃える。
2. **immedio 側でマッピングとルーターを作成する** immedio 側で必要なプロパティのマッピングを作成する。Box の識別子と immedio 側のプロパティ名で突合するため、マッピング元フォーム項目の設定は不要（設定画面でマッピング元フォーム項目を削除）。作成したマッピングを使ってルーターを組む。
3. **アンケートに API Key を設定する** immedio のルーター一覧画面から該当ルーターの API Key をコピーし、Box のアンケート設定画面の「immedioルーターAPI Key」欄に貼り付ける。

設定が完了すると、アンケート回答後に immedio ルーター側で設定した挙動が実行されるようになります。

### 連携の仕組み

* 閲覧者がアンケートに回答すると、Box が閲覧ページ上に immedio ルーターの SDK (`https://sdk.immedio.io/sdk.js`) を読み込む
* SDK 経由で `submitFormData` が呼ばれ、次の情報が immedio ルーターへ送信される
  * メールアドレス（メールアドレス認証などで取得済みのもの）
  * 氏名
  * 各アンケート項目の識別子と回答値
* 送信内容はコンテンツごとにセッション内に保持され、**同じコンテンツで複数のアンケートに回答した場合はそれまでの回答とマージ**されて送信される（別コンテンツの回答は混ざらない）

### 特別な識別子: `person_name`

アンケート項目の識別子として `person_name` を使用すると、その項目の回答が immedio ルーター側で**リードの氏名**として扱われます。氏名を取得したい場合は、識別子を `person_name` にしたアンケート項目を用意してください。

`person_name` の回答が無い場合は、メールアドレスが氏名の代わりとして送信されます。

### API Key が未設定の場合

API Key が未設定のアンケートでは immedio ルーターへの連携は行われず、Box 内での回答保存のみが行われます。immedio 連携を使わないケースでは空欄のまま利用できます。

### 外部サイトへの埋め込み時のメールアドレス引き継ぎ

Box を外部サイトに埋め込む方法として、**埋め込みタグ（埋め込みタグ）** と **iframe** の 2 通りがあります。親サイト側の immedio 連携が持っているメールアドレスを Box のアンケートに引き継げるかは、埋め込み方式とドメイン構成によって挙動が変わります。

| 埋め込み方式         | 親サイトと Box のドメイン                                                 | 親サイトが持つメールアドレスの引き継ぎ                                                            |
| -------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| 埋め込みタグ（埋め込みタグ） | 任意（別ドメインでも可）                                                    | 可能。埋め込みタグ は親サイト上で動くため、親サイトの immedio 連携が保持しているメールアドレスをそのまま参照できる                 |
| iframe         | 親と Box が同じドメイン配下（例: 親 `immedio.io` / iframe `box.immedio.io`）   | 可能。共有 Cookie 経由で引き継げる                                                          |
| iframe         | 親が Box とは無関係のドメイン（例: 親 `example.com` / iframe `box.immedio.io`） | **不可**。ブラウザの Cookie 分離により親サイトのメールアドレスは iframe から参照できない。初回は Box 側でのメールアドレス入力が必要 |

外部サイトへの埋め込みで immedio ルーター連携を最大限活用したい場合は、**基本的に 埋め込みタグ の利用を推奨**します。

## アンケート回答の確認

アンケート回答は、各資料の**リード一覧**および**リード詳細画面のセッション詳細**から確認できます。

* リード一覧の「アンケート」列に「あり」と表示されているリードをクリックし、セッションを開くと、セッション内タブの右端に「アンケート結果」が表示される
* 専用の回答一覧画面はなく、リード単位・セッション単位での参照になる

### CSVダウンロード

リード一覧の「CSVダウンロード」からセッション一覧をエクスポートすると、そのセッションで取得されたアンケート回答も同じ CSV に列として出力されます。列見出しにはアンケート項目の**識別子**が使われます。

### アンケート回答時のワークフロー

アンケート回答をトリガーに、ファイル側の「ワークフロー」で発火条件「アンケート回答完了」を選択して各種アクションを実行できます。選択できるアクションは次の通りです（PDF・動画で選択肢に若干差があります）。

* メール通知
* Slack 通知
* Salesforce プロパティ更新（[CRMプロパティマッピング](#crm-property-mapping)参照）
* Salesforce 取引先プロパティ更新（[CRMプロパティマッピング](#crm-property-mapping)参照）
* Salesforce キャンペーンメンバー作成
* Salesforce ToDo 作成
* HubSpot プロパティ更新（[CRMプロパティマッピング](#crm-property-mapping)参照）
* HubSpot ToDo 作成

通知メール・Slack 通知に「アンケート回答」項目を含めるかどうかは [通知管理](/immedio-box/notifications/index.md) から **コンテンツ種別ごと（PDF・動画・ドキュメント・URL）** に設定できます。ルームは通知管理での個別 ON/OFF に対応していません。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.immedio.io/immedio-box/questionnaires/index.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.