アンケート管理
概要
顧客満足度調査や口コミ誘導のためのアンケートを作成・配信・集計する画面。SMS経由で配信し、回答後にGoogle口コミ投稿へ誘導する機能を持つ。
アンケート一覧
| No | 表示項目 | 表示形式 | 説明 |
|---|---|---|---|
| 1 | アンケート名 | 文字列 | name |
| 2 | ステータス | バッジ | status |
| 3 | 開始日 | YYYY/MM/DD | start_date |
| 4 | 終了日 | YYYY/MM/DD | end_date |
| 5 | 総閲覧数 | 数値 | total_views |
| 6 | SMS経由閲覧数 | 数値 | views_by_sms |
| 7 | QRコード経由閲覧数 | 数値 | views_by_qr_code |
| 8 | アーカイブ | フラグ | is_archived |
アンケート作成フォーム
| 項目 | 種別 | 必須 | 備考 |
|---|---|---|---|
| アンケート名 | テキスト | YES | 最大255文字 |
| ヘッダー | テキスト | NO | 表示用ヘッダー |
| ロケーション | セレクトボックス | NO | 紐付きGBPロケーション |
| 開始日 | 日付 | NO | 公開開始日 |
| 終了日 | 日付 | NO | 公開終了日 |
| 口コミボタン表示閾値 | 数値 | YES | 指定評価以上でGoogle口コミボタン表示（デフォルト: 3） |
| 画面コンテンツタイプ | セレクトボックス | NO | 画面のカスタマイズタイプ |
操作
- アンケート作成/編集
- SMS配信: アンケートURLをSMSで送信
- 回答閲覧: 回答データの詳細確認
- 回答エクスポート: CSV/Excelダウンロード
- アーカイブ: アンケートのアーカイブ
データベース
| No | 表示項目 | テーブル名（物理） | カラム名（物理） |
|---|---|---|---|
| 1 | アンケート名 | mappy_questionnaires | name |
| 2 | ステータス | mappy_questionnaires | status |
| 3 | 総閲覧数 | mappy_questionnaires | total_views |
| 4 | 口コミボタン閾値 | mappy_questionnaires | display_google_review_button_at |
| 5 | ロケーション | mappy_gbp_locations | title |
| 6 | ユーザー | mappy_users | login_id |
API
| メソッド | エンドポイント | 説明 |
|---|---|---|
| POST | /api/mappy/questionnaires | アンケート保存 |
| GET | /api/mappy/questionnaires/sms | SMS配信用アンケート取得 |
| GET | /api/mappy/questionnaires/{questionnaire}/detail | アンケート詳細 |
| POST | /api/mappy/questionnaires/{questionnaire}/sms/status | SMS配信ステータス更新 |
| POST | /api/mappy/export/questionnaire/answers | 回答エクスポート |
| GET | /api/mappy/guest/questionnaires/{slug} | ゲスト用アンケート表示 |
| POST | /api/mappy/guest/questionnaires | ゲスト用回答送信 |