# バウチャーシステム

バウチャーシステムを使えば、プレイヤーへのリワードとして配布できるプロモーションコードを管理できます。

## バウチャーセットとは？

バウチャーセットは、特定の目的で整理されたコードのコレクションです：

- ホリデープロモーションコード
- 商品割引コード
- ギフトカードコード
- イベント固有のコード

各セットには：

- わかりやすい名前
- 任意の説明
- 有効期限
- 複数のバウチャーコード

---

## バウチャーセットの作成

### ステップ1：バウチャーへ移動

1. **組織**ダッシュボードへ移動
2. メニューの**バウチャー**をクリック

### ステップ2：新しいセットを作成

1. **セットを作成**をクリック
2. セットの詳細を入力：

| フィールド | 説明                     | 必須   |
| ---------- | ------------------------ | ------ |
| セット名   | セットのわかりやすい名前 | はい   |
| 説明       | バウチャーの目的         | いいえ |
| 有効期限   | コードの期限             | いいえ |

3. **作成**をクリック

<video autoplay loop muted playsinline preload="none">
  <source src="/vdo/prize/create-voucher.mp4" type="video/mp4" />
</video>

---

## バウチャーコードの追加

セットにコードを追加する3つのオプション：

### オプション1：CSVアップロード

コードを含むファイルをアップロード：

1. **CSVをアップロード**をクリック
2. ファイルを選択（1行に1コード）
3. コードをプレビュー
4. アップロードを確認

**CSV形式：**

```
SUMMER2024-001
SUMMER2024-002
SUMMER2024-003
```

### オプション2：コードを貼り付け

コードを直接貼り付け：

1. **CSVをアップロード**をクリックするか、アップロードモーダルを開く
2. テキストエリアにコードを貼り付け（1行に1つ）
3. **アップロード**をクリック

<video autoplay loop muted playsinline preload="none">
  <source src="/vdo/prize/add-code-voucher.mp4" type="video/mp4" />
</video>

### オプション3：コードを生成

ユニークなコードを自動生成：

1. **生成**をクリック
2. 生成設定を構成：

| 設定                 | 説明                                |
| -------------------- | ----------------------------------- |
| コード数             | 生成する数（例：100）               |
| コードプレフィックス | 任意のプレフィックス（例："PROMO"） |
| ランダム部分の長さ   | ランダム文字の長さ                  |

3. サンプルコードをプレビュー
4. **生成**をクリック

**生成されるコードの例：**

- `PROMO-A8K2M9X1`
- `PROMO-B3N5P7Q2`
- `PROMO-C1R4S6T8`

<video autoplay loop muted playsinline preload="none">
  <source src="/vdo/prize/generate-code-voucher.mp4" type="video/mp4" />
</video>

---

## バウチャーの管理

### コードの表示

バウチャーセットを展開するとすべてのコードが表示されます：

- コード値
- ステータス（利用可能、受取済み、期限切れ、無効化）
- 割り当てられたゲーム（リンクされている場合）
- アクション

### バウチャーのステータス

| ステータス   | 説明                 |
| ------------ | -------------------- |
| **利用可能** | 受取準備完了         |
| **受取済み** | プレイヤーに割り当て |
| **期限切れ** | セットの有効期限経過 |
| **無効化**   | 手動で非アクティブ化 |

![バウチャーダッシュボード](/img/prize/dashbaord-voucher.jpg)

### コードのコピー

コードの横にあるコピーアイコンをクリックしてクリップボードにコピー。

### コードのエクスポート

セット内のすべてのコードをエクスポート：

1. バウチャーセットの**エクスポート**をクリック
2. CSVファイルをダウンロード
3. 外部追跡やバックアップに使用

![バウチャーコードのエクスポート](/img/prize/export-voucher.jpg)

### コードの削除

個別のコードまたはセット全体を削除：

- **個別コード**：削除アイコンをクリック
- **セット全体**：セットヘッダーの削除をクリック

![バウチャーコードの削除](/img/prize/delete-voucher.jpg)

:::caution[警告]
バウチャーセットの削除は、受取済みコードを含むすべてのコードを完全に削除します。この操作は元に戻せません。
:::
---

## バウチャーとゲームのリンク

バウチャーセットをゲーム賞品に接続：

### ゲーム作成時

1. ゲームエディターで賞品を有効化
2. 「バウチャーセット」タイプの賞品スロットを追加
3. バウチャーセットを選択
4. 確率を設定

**ゲームとバウチャーセットの設定：**

<video autoplay loop muted playsinline preload="none">
  <source src="/vdo/prize/game-code-voucher.mp4" type="video/mp4" />
</video>

**バウチャーページでの結果：**

![ゲームにリンクされたバウチャーの結果](/img/prize/result-voucher.png)

### 配布の仕組み

1. プレイヤーがバウチャー賞品に当選
2. システムがセットから利用可能なコードを選択
3. コードが受取済みとしてマーク
4. プレイヤーにユニークなコードを表示
5. コードがセッション/メールにリンク

---

## ベストプラクティス

### 命名規則

明確でわかりやすい名前を使用：

- ✅ `Summer-Sale-2024-20%Off`
- ✅ `Launch-Event-Free-Trial`
- ❌ `Codes1`
- ❌ `Test`

### コードプレフィックス

キャンペーンを識別するためにプレフィックスを使用：

- `SUMMER24-` — 夏のキャンペーン
- `LAUNCH-` — 製品ローンチ
- `VIP-` — 限定コード

### 在庫計画

| キャンペーン規模         | 推奨コード数   |
| ------------------------ | -------------- |
| 小規模（500プレイ未満）  | 100-200コード  |
| 中規模（500-5000プレイ） | 500-1000コード |
| 大規模（5000プレイ以上） | 2000+コード    |

:::tip[バッファ]
コード切れを防ぐために、予想プレイ数より20-30%多くのコードを生成しておきましょう。
:::
### 有効期限の管理

- 現実的な有効期限を設定
- キャンペーン終了前にリマインダーを送信
- 延長用のバックアップコードを用意

---

## トラブルシューティング

### 「利用可能なバウチャーがありません」

セットが空であるか、すべてのコードが受取済みです。コードを追加するか、新しいセットを作成してください。

### ゲームにコードが表示されない

1. バウチャーセットが賞品にリンクされているか確認
2. セットが期限切れでないか確認
3. コードが「利用可能」ステータスであることを確認

### プレイヤーがコードを受け取らなかった

1. コードが受取済み（バウチャーリストに表示）か確認
2. プレイヤーのメールアドレスが取得されているか確認
3. メール配信の問題を確認

## 次のステップ

- [賞品設定](/ja/rewards/prizes)について学ぶ
- バウチャー賞品付きの[ゲームを作成](/ja/creating-games/overview)