> ## 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 (レガシー) のクイックスタート

> 初期カタログのセットアップ、仮想通貨の構成、基本的なアイテムとストアの作成をカバーする PlayFab レガシー Economy (v1) のクイックスタート。

# クイックスタート (レガシー Economy)

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

収益化を機能させることは、ゲームにおいて最大の課題の 1 つです。PlayFab は、通貨、アイテム、インベントリの 3 つの基礎要素の上に構築することで、この体験を簡素化します。

このクイックスタートでは、次のことを行います。

1. 仮想通貨をセットアップします。
2. アイテムを作成します。
3. プレイヤーのインベントリにアイテムを追加します。
4. 経済をカスタマイズするための次のステップを学びます。

## 仮想通貨のセットアップ

仮想通貨は、ゲーム内経済の基盤です。プレイヤーやキャラクターにこれらの通貨を付与でき、その通貨を使用してアイテムを購入したり交換したりできます。

アイテムには、仮想通貨または実際のお金のコストを設定できます。各タイトルは、任意の複数の仮想通貨をサポートでき、ゲームが希望するあらゆる交換手段 (たとえば、ゴールド、ジェム、ハート、星間クレジット) を実装するための柔軟性を提供します。

仮想通貨を作成するには:

1. **Game Manager** を開き、左側のサイド バーで **Economy** を選択します。
2. **Currency** タブを選択します。
3. **New Currency** を選択し、以下のフィールドを変更します (下図参照)。
   * **Currency code (2 uppercase characters)** を **GD** に設定します。
   * **Display name** を **Gold** に設定します。
4. **SAVE CURRENCY** を選択します。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=fcf039d9e16ac42519f73544b6f3a8fd" alt="アイテムを作成" width="1200" height="394" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png" />

通貨がセットアップされたので、カタログ アイテムに仮想通貨に対応する価格を割り当てることができます。

## アイテムの作成

多くのゲームは、シールド、レベルのアンロック、パワーアップなど、購入するアイテムをプレイヤーに提供しています。これらのアイテムはカタログで指定されます。プレイヤーがカタログからアイテムを購入する前に、カタログを構成するためにアイテムを作成する必要があります。

アイテムを持つカタログを作成するには:

1. 左側のサイド バーで **Economy** を選択し、**Catalogs** タブを選択します。

2. **NEW CATALOG** ボタンを選択し、**Catalog version** として **main** を入力します。ID が **One** のアイテムが自動的に追加されます。

3. **One** を選択し、以下のフィールドを変更します (下図参照)。

   * **Item ID** を **apple** に設定します。
   * **Display name** を **apple** に設定します。
   * **Description** を **Perfectly normal apple** に設定します。

4. **PRICES** セクションはフォームの下部にあります。

5. リンゴの gold (**GD**) での価格を **5** に設定します。

6. **SAVE ITEM** ボタンを選択します。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/create-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=b07c6dc306edea1d41c9a4d73f5c3915" alt="通貨を編集または保存" width="1280" height="1200" data-path="images/playfab/economy-monetization/economy/tutorials/create-item.png" />

## プレイヤーのインベントリにアイテムを追加する

PlayFab の [Player Item Management (Server)](xref:titleid.playfabapi.com.server.playeritemmanagement) および [Player Item Management (Client)](xref:titleid.playfabapi.com.client.playeritemmanagement) API は、以下のアイテム購入戦略をサポートします。

* 実際のお金
* 仮想通貨
* 別のアイテムの購入に基づく、トリガーされたアイテムの付与
* ロックされた (略奪可能/購入可能なキーを持つ) ボックスとロック解除されたボックス
* ランダム結果テーブル
* ゲーム内の有料または無料イベントに基づいて付与される購入不可能なアイテム
* その他のシナリオ、特に [Azure Functions を使用した PlayFab CloudScript](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)

**仮想通貨で購入することで、プレイヤーのインベントリにアイテムを追加します。**

1. ゲームで、仮想通貨が付与されたプレイヤーとしてサインインします。(必要に応じて、詳細は [プレイヤーに仮想通貨を付与する](/services/playfab/economy-monetization/economy/items/quickstart#giving-virtual-currency-to-a-player) を参照)。

2. 以下のパラメーターをリクエストに含めて [GetCatalogItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getcatalogitems) を呼び出します。
   * `CatalogVersion = "main"`

3. 結果の `Catalog` に、**GD** 価格 **5** の **apple** が含まれていることを確認します。

4. 以下のパラメーター値をリクエストに含めて [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) を呼び出し、**apple** を購入します。

   * `CatalogVersion = "main"`
   * `ItemId = "apple"`
   * `VirtualCurrency  = "GD"`
   * `Price =  5`

5. 最後に、[GetUserInventory](xref:titleid.playfabapi.com.client.playeritemmanagement.getuserinventory) を呼び出し、そのメソッドの結果を確認します。プレイヤーの `Inventory` のアイテム配列に、リンゴが表示されるはずです。

## 経済をカスタマイズするための次のステップ

仮想通貨でサポートされたアイテムを持つカタログを取得したら、以下で経済に色を付けることができます。

* **実世界の購入**: [PlayFab、Unity IAP、Android の使い始め](/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android) および [非レシート支払処理](/services/playfab/economy-monetization/economy/tutorials/non-receipt-payment-processing) チュートリアルでは、仮想経済を既存のストアと接続する方法を説明します。
* **カタログの活用**: バンドル、コンテナ、ドロップ テーブルを作成します。詳細については、[カタログ](/services/playfab/economy-monetization/economy/items/catalogs) のチュートリアルを参照してください。
* **アイテム属性の使用**: 複数の価格を定義し、スタック可能、取引可能、限定版の [アイテム](/services/playfab/economy-monetization/economy/items) を指定します。
* **ユニークなゲーム内ベンダーやセール イベントのセットアップ**: [ストアとセール](/services/playfab/economy-monetization/economy/tutorials/stores-and-sales) を使用します。
* **プレイヤー セグメントを作成してストアを使用する**: ゲーム ライフサイクルのどこにいるかに関係なく、異なるアイテムやバンドルのオファーをプレイヤーに提供します。例については、[プレイヤー セグメント向けのカスタム ストア](/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments) チュートリアルを参照してください。
* **経済データの収集**: PlayFab の [レポート](/services/playfab/data-analytics/learn-data/reports/overview) を使用してゲームを改善および反復できるようにします。


## Related topics

- [アイテム (レガシー Economy) のクイックスタート](/ja-jp/services/playfab/economy-monetization/economy/items/quickstart.md)
- [トーナメントとリーダーボードのクイックスタート](/ja-jp/services/playfab/community/leaderboards/tournaments-leaderboards/quickstart.md)
- [クイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [不正防止のクイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)
- [エンティティ クイックスタート](/ja-jp/services/playfab/live-service-management/game-configuration/entities/quickstart.md)