> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy (Legacy) のクーポンとプロモーション

> Game Manager から PlayFab Legacy Economy のクーポンを生成および引き換え、バンドルまたは CloudScript と組み合わせてゲーム内プロモーションを実現します。

# クーポンとプロモーション (Legacy Economy)

<Info>
  Economy v1 API はメンテナンス モードにあり、新機能は追加されず、バグ修正のみが行われます。**v1 API は当面の間、維持されます。** PlayFab Economy の次のバージョンの詳細については、[Economy v2 の概要](/services/playfab/economy-monetization/economy-v2/overview) を参照してください。
</Info>

クーポンは、顧客がゲーム内でインベントリ アイテムを引き換えるために生成できる文字列トークンです。バンドルや CloudScript と組み合わせることで、これらのクーポンはゲーム内のほぼあらゆる機能をトリガーするために使用できます。

## 要件

* [カタログ](/services/playfab/economy-monetization/economy/items/catalogs)、バンドル、コンテナーに関する知識。
* [Game Manager](/services/playfab/live-service-management/gamemanager) に関する知識。
* [プレイヤー インベントリ](/services/playfab/player-progression/player-data/player-inventory) に関する知識。

## クーポン生成と引き換えの手順

以下のすべての例では、最初の基本ステップとしてクーポンを生成します。これは Game Manager で行います。

**Game Manager** から:

* **タイトル** に移動します。
* 左側のメニューから **Economy** を選択します。
* **Catalogs** タブに移動します。

3 つのタブ セクション (**Items**、**Bundles**、**Containers**) のいずれにも **Coupons** リンクがあります。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=01c2a878fe4e703656b294f53ee70c21" alt="Game Manager - Economy - Catalog Items - Coupons ボタン" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png" />

このリンクを開くと、セクション内の任意のアイテムに対してクーポンを生成できるウィンドウが表示されます。特定のアイテムに対してクーポンを作成したい場合:

* **Items** タブで **Coupons** を選択します。
* バンドルの **Coupons** は **Bundles** の下、コンテナーの **Coupons** は **Containers** の下にあります。

ポップアップ ウィンドウは、以下に示すものと似ています (アイテムのリストは、お使いのタイトルと一致するはずです。表示されているアイテムは、[ドロップ テーブル](/services/playfab/economy-monetization/economy/tutorials/drop-tables) のチュートリアルで説明されています)。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=ca852ef6cb03a6bc62d187fa93dca085" alt="Game Manager - クーポンの生成" width="1053" height="733" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png" />

クーポンの生成を完了するには:

* 生成する **Coupons** の数を選択します。

* 次に、**Coupons** で生成される **Item** を選択します。

* **Coupons** のリストが記載された **CSV** テキスト ファイルをダウンロードできます。

例のリンクを 1 つ選択すると、次のようにコンマ区切りの 10 個の **Coupons** が生成されます。

```xml theme={null}
65g-d4q5-zph,ahs-aofk-5ip,rqp-pk6c-yuu,58d-64h9-a6q,zxk-jtmi-5a1,oeu-6e4z-365,mfy-euhb-qj3,ru9-r1ux-wzy,shj-54cm-5oh,719-7hxc-pzz
```

最後に、コードを入力できる GUI を提供し、[RedeemCoupon](xref:titleid.playfabapi.com.client.playeritemmanagement.redeemcoupon) を呼び出すことで、顧客はクーポンを引き換えることができます。

```csharp theme={null}
// Unity/C#
void UseCoupon(string couponCode)
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog
    var request = new RedeemCouponRequest
    {
        CatalogVersion = primaryCatalogName,
        CouponCode = couponCode // This comes from player input, in this case, one of the coupon codes generated above
    };
    PlayFabClientAPI.RedeemCoupon(request, LogSuccess, LogFailure);
}
```

### 例: インベントリ アイテム クーポン

クーポンの最も単純な使い方は、インベントリ アイテムを贈ることです。カタログを作成したら、前述の手順に従って通常のアイテムに対するクーポンを生成できます。このケースでは他に特別なステップはありません。

### 例: 仮想通貨クーポン *または* 複数アイテム クーポン

クーポンは [仮想通貨](/services/playfab/economy-monetization/economy/tutorials/currencies) を直接付与することはできず、単一のアイテムしか付与できません。

ただし、バンドルを使用すると、インベントリ アイテムをアイテム グループや仮想通貨にシームレスに変換できます。VC の例では、VC を内容とする新しいバンドル アイテムを作成する必要があります。

バンドルを **15 秒** で期限切れになるように設定します。こうすると、プレイヤーはバンドルを開いた瞬間に VC を目にし、中間アイテムを目にすることはありません。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=1811ef16679c9be97687ef51cc436fc0" alt="Game Manager - Economy - カタログ バンドルの編集" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png" />

複数アイテムも同じ仕組みで動作します。

* 複数のアイテム、または [ドロップ テーブル](/services/playfab/economy-monetization/economy/tutorials/drop-tables) を含むバンドルを作成します。
* **15 秒** で期限切れになるように設定します。
* クーポンがバンドルを生成できます。
* バンドルは複数のアイテムに変換されます。
* 中間のバンドル アイテムは消えます。

## 使用シナリオ

* カンファレンスでの物理的な報酬:
  * クーポン コードのリストを印刷し、カンファレンスでノベルティとして配布できます。
* フォーラム、[プッシュ通知](/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart)、電子メールなどのゲーム外コミュニケーション。
  * 再獲得キャンペーンやその他のコミュニティ アウトリーチの一環として、プレイヤーに *直接* クーポン コードを送信します。
* トーナメント:
  * [リセット可能なリーダーボード](/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards) を使用する場合、上位プレイヤーにクーポンを送信します。

<Note>
  この場合、インベントリ アイテムを直接配布することもできるので、ゲームにより関連する方法を選択してください。
</Note>

## ベスト プラクティス

PlayFab インベントリを使用する場合、インベントリ サイズは比較的小さく保つ必要があります - プレイヤー 1 人あたり *合計 100 アイテム未満*。*多すぎるアイテム* を付与するバンドルは、スロットルされたりレート制限を受けたりする可能性があります。


## Related topics

- [PlayFab Economy ドキュメント](/ja-jp/services/playfab/economy-monetization/economy/index.md)
- [プロモーション コードを注文する](/ja-jp/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-promo-codes.md)
- [XBOX services ユーザー特権のクライアント側での使用](/ja-jp/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)
- [PlayFab Economy v2 ドキュメント](/ja-jp/services/playfab/economy-monetization/index.md)
- [消費型ベースのエコシステム](/ja-jp/publishing/xstore-commerce/xstore-consumables.md)