# トライアル用キーコード配布機能 管理画面操作マニュアル

## 1. 概要

本マニュアルでは、トライアル用キーコード配布機能の管理画面の操作方法を説明します。

---

## 2. 管理画面メニュー

トライアル機能には以下の3つの管理画面があります。

| メニュー | URL | 説明 |
|----------|-----|------|
| トライアル設定管理 | `/agent/adm_trial_settings_list.php` | トライアルの設定を管理 |
| 配布履歴一覧 | `/agent/adm_trial_history_list.php` | キーコード配布の履歴を確認 |
| メールテンプレート管理 | `/agent/adm_trial_email_template_list.php` | フォローメールのテンプレートを管理 |

---

## 3. トライアル設定管理

### 3.1 一覧画面

**URL:** `/agent/adm_trial_settings_list.php`

#### 画面説明

| 項目 | 説明 |
|------|------|
| ID | トライアル設定の識別番号 |
| トライアル名 | 設定した名称 |
| 代理店 | 対象の代理店名 |
| 期間 | 開始日〜終了日 |
| 配布数/上限 | 現在の配布数 / 配布上限（無制限の場合は「無制限」） |
| ステータス | 有効/無効 |

#### 操作

- **検索:** キーワードや代理店で絞り込み検索
- **新規登録:** 新しいトライアル設定を作成
- **変更:** 既存の設定を編集
- **削除:** 設定を削除（関連する履歴も削除されます）

### 3.2 新規登録・編集画面

**URL:** `/agent/adm_trial_settings_edit.php`

#### 入力項目

| 項目 | 説明 | 入力例 | 必須 |
|------|------|--------|------|
| トライアル名 | ユーザーに表示される名称 | 春のキャンペーントライアル | ○ |
| 代理店 | 対象の代理店を選択 | - | ○ |
| 開始日 | 受付開始日（この日から申込可能） | 2025-04-01 | ○ |
| 終了日 | 受付終了日（この日まで申込可能） | 2025-06-30 | ○ |
| 配布上限 | 配布できる最大数。0は無制限 | 100 | - |
| フォローメール | チェックするとフォローメールを送信 | - | - |
| ステータス | 有効にすると申込受付開始 | 有効 | ○ |

#### 注意事項

- 開始日は終了日より前の日付を指定してください
- 配布上限を超えると新規申込ができなくなります
- ステータスを「無効」にすると申込受付が停止します

---

## 4. 配布履歴一覧

### 4.1 一覧画面

**URL:** `/agent/adm_trial_history_list.php`

#### 画面説明

| 項目 | 説明 |
|------|------|
| ID | リクエストの識別番号 |
| トライアル名 | 申込されたトライアルの名称 |
| 代理店 | 対象の代理店名 |
| メールアドレス | 申込者のメールアドレス |
| キーコード | 配布されたキーコード |
| フォローメール | 受信/停止 |
| 申込日時 | 申込が行われた日時 |

#### 検索・フィルタ

| フィルタ項目 | 説明 |
|--------------|------|
| キーワード | メールアドレスまたはキーコードで検索 |
| 代理店 | 代理店で絞り込み |
| トライアル | トライアル設定で絞り込み |
| 期間 | 申込日の範囲で絞り込み |

#### 活用例

- **配布状況の確認:** 特定のトライアルの配布数を確認
- **キーコードの追跡:** 特定のキーコードがどのメールアドレスに配布されたか確認
- **期間別集計:** 日付範囲を指定して期間ごとの配布数を確認

---

## 5. メールテンプレート管理

### 5.1 一覧画面

**URL:** `/agent/adm_trial_email_template_list.php`

#### 画面説明

| 項目 | 説明 |
|------|------|
| ID | テンプレートの識別番号 |
| テンプレート名 | 設定した名称 |
| 代理店 | 対象の代理店名 |
| 対象トライアル | 適用されるトライアル設定（全設定共通/特定設定） |
| 送信タイミング | 配布後N日後 |
| 件名 | メールの件名（30文字まで表示） |
| ステータス | 有効/無効 |

### 5.2 新規登録・編集画面

**URL:** `/agent/adm_trial_email_template_edit.php`

#### 入力項目

| 項目 | 説明 | 入力例 | 必須 |
|------|------|--------|------|
| テンプレート名 | 管理用の名称 | 3日後フォローメール | ○ |
| 代理店 | 対象の代理店を選択 | - | ○ |
| 対象トライアル設定 | 特定の設定のみに適用する場合に選択 | - | - |
| 送信タイミング | 配布後N日後に送信 | 3 | ○ |
| 件名 | メールの件名 | 【〇〇】トライアルのご利用はいかがですか？ | ○ |
| 本文 | メールの本文 | （下記参照） | ○ |
| ステータス | 有効にすると送信対象になる | 有効 | ○ |

#### 使用可能な変数

本文内で以下の変数を使用できます。送信時に自動的に置換されます。

| 変数 | 説明 | 置換例 |
|------|------|--------|
| `{{email}}` | 申込者のメールアドレス | user@example.com |
| `{{keycode}}` | 配布したキーコード | ABCD-1234-EFGH-5678 |
| `{{unsubscribe_url}}` | 配信停止URL | https://example.com/trial/unsubscribe.php?token=xxx |

#### 本文テンプレート例

```
{{email}} 様

先日はトライアルにお申し込みいただき、ありがとうございます。

お送りしたキーコード（{{keycode}}）のご利用はいかがでしょうか？

製品についてご不明な点がございましたら、
お気軽にお問い合わせください。

━━━━━━━━━━━━━━━━━━━━━━━━━━
〇〇株式会社 サポートセンター
お問い合わせ: support@example.com
━━━━━━━━━━━━━━━━━━━━━━━━━━

※このメールの配信停止はこちら
{{unsubscribe_url}}
```

### 5.3 複数テンプレートの活用

フォローメールを複数回送信したい場合は、送信タイミングの異なるテンプレートを複数作成します。

**例:**
| テンプレート名 | 送信タイミング |
|----------------|----------------|
| 3日後フォローメール | 3日後 |
| 7日後フォローメール | 7日後 |
| 14日後フォローメール | 14日後 |

---

## 6. 運用のポイント

### 6.1 定期確認項目

| 確認項目 | 頻度 | 確認方法 |
|----------|------|----------|
| キーコード在庫 | 週1回 | 配布履歴の配布数と用意したキーコード数を比較 |
| 配布状況 | 日次 | 配布履歴一覧で当日の配布数を確認 |
| フォローメール送信 | 日次 | ログまたはSlack通知で送信数を確認 |

### 6.2 トライアル終了時の対応

1. トライアル設定のステータスを「無効」に変更
2. 必要に応じてメールテンプレートも「無効」に変更
3. 配布履歴は削除せず、記録として保持

### 6.3 新規トライアル開始時の手順

1. 必要なキーコードを `licences` テーブルに登録
2. トライアル設定を新規作成
3. フォローメールテンプレートを作成（必要に応じて）
4. テスト申込を実施して動作確認
5. ステータスを「有効」にして公開

---

## 7. よくある質問

### Q1. 配布上限を変更したい

**A:** トライアル設定管理から対象の設定を「変更」し、配布上限の値を修正してください。

### Q2. フォローメールを途中で止めたい

**A:** 以下のいずれかの方法で対応できます。
- トライアル設定の「フォローメール」チェックを外す（全員に対して停止）
- メールテンプレートのステータスを「無効」にする（特定のテンプレートのみ停止）

### Q3. 特定のユーザーだけフォローメールを止めたい

**A:** 該当ユーザーが配信停止URLをクリックすることで停止できます。管理画面からの個別停止は現在対応していません。

### Q4. 過去のトライアル設定を削除してもよいか

**A:** 削除すると関連する配布履歴やフォローメール送信履歴も削除されます。記録を残したい場合はステータスを「無効」にして保持することをお勧めします。

### Q5. 同じメールアドレスで複数回申し込めるか

**A:** 同一トライアル設定に対しては1回のみ申込可能です。異なるトライアル設定であれば、同じメールアドレスで申込可能です。

---

## 8. 画面遷移図

```
トライアル設定管理
├── 一覧 (adm_trial_settings_list.php)
│   ├── 新規登録 → 編集 → 確認 → 完了
│   ├── 変更 → 編集 → 確認 → 完了
│   └── 削除 → 確認 → 完了
│
配布履歴一覧
└── 一覧 (adm_trial_history_list.php) ※参照のみ

メールテンプレート管理
├── 一覧 (adm_trial_email_template_list.php)
│   ├── 新規登録 → 編集 → 確認 → 完了
│   ├── 変更 → 編集 → 確認 → 完了
│   └── 削除 → 確認 → 完了
```

---

## 9. お問い合わせ

本機能に関するお問い合わせは、システム管理者までご連絡ください。