Skip to main content

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

Economy v1 API はメンテナンス モードにあり、新機能は追加されず、バグ修正のみが行われます。v1 API は当面の間維持されます。 次のバージョンの PlayFab Economy の詳細については、Economy v2 の概要 を参照してください。
収益化を機能させることは、ゲームにおいて最大の課題の 1 つです。PlayFab は、通貨、アイテム、インベントリの 3 つの基礎要素の上に構築することで、この体験を簡素化します。 このクイックスタートでは、次のことを行います。
  1. 仮想通貨をセットアップします。
  2. アイテムを作成します。
  3. プレイヤーのインベントリにアイテムを追加します。
  4. 経済をカスタマイズするための次のステップを学びます。

仮想通貨のセットアップ

仮想通貨は、ゲーム内経済の基盤です。プレイヤーやキャラクターにこれらの通貨を付与でき、その通貨を使用してアイテムを購入したり交換したりできます。 アイテムには、仮想通貨または実際のお金のコストを設定できます。各タイトルは、任意の複数の仮想通貨をサポートでき、ゲームが希望するあらゆる交換手段 (たとえば、ゴールド、ジェム、ハート、星間クレジット) を実装するための柔軟性を提供します。 仮想通貨を作成するには:
  1. Game Manager を開き、左側のサイド バーで Economy を選択します。
  2. Currency タブを選択します。
  3. New Currency を選択し、以下のフィールドを変更します (下図参照)。
    • Currency code (2 uppercase characters)GD に設定します。
    • Display nameGold に設定します。
  4. SAVE CURRENCY を選択します。
通貨がセットアップされたので、カタログ アイテムに仮想通貨に対応する価格を割り当てることができます。

アイテムの作成

多くのゲームは、シールド、レベルのアンロック、パワーアップなど、購入するアイテムをプレイヤーに提供しています。これらのアイテムはカタログで指定されます。プレイヤーがカタログからアイテムを購入する前に、カタログを構成するためにアイテムを作成する必要があります。 アイテムを持つカタログを作成するには:
  1. 左側のサイド バーで Economy を選択し、Catalogs タブを選択します。
  2. NEW CATALOG ボタンを選択し、Catalog version として main を入力します。ID が One のアイテムが自動的に追加されます。
  3. One を選択し、以下のフィールドを変更します (下図参照)。
    • Item IDapple に設定します。
    • Display nameapple に設定します。
    • DescriptionPerfectly normal apple に設定します。
  4. PRICES セクションはフォームの下部にあります。
  5. リンゴの gold (GD) での価格を 5 に設定します。
  6. SAVE ITEM ボタンを選択します。

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

PlayFab の Player Item Management (Server) および Player Item Management (Client) API は、以下のアイテム購入戦略をサポートします。
  • 実際のお金
  • 仮想通貨
  • 別のアイテムの購入に基づく、トリガーされたアイテムの付与
  • ロックされた (略奪可能/購入可能なキーを持つ) ボックスとロック解除されたボックス
  • ランダム結果テーブル
  • ゲーム内の有料または無料イベントに基づいて付与される購入不可能なアイテム
  • その他のシナリオ、特に Azure Functions を使用した PlayFab CloudScript
仮想通貨で購入することで、プレイヤーのインベントリにアイテムを追加します。
  1. ゲームで、仮想通貨が付与されたプレイヤーとしてサインインします。(必要に応じて、詳細は プレイヤーに仮想通貨を付与する を参照)。
  2. 以下のパラメーターをリクエストに含めて GetCatalogItems を呼び出します。
    • CatalogVersion = "main"
  3. 結果の Catalog に、GD 価格 5apple が含まれていることを確認します。
  4. 以下のパラメーター値をリクエストに含めて PurchaseItem を呼び出し、apple を購入します。
    • CatalogVersion = "main"
    • ItemId = "apple"
    • VirtualCurrency = "GD"
    • Price = 5
  5. 最後に、GetUserInventory を呼び出し、そのメソッドの結果を確認します。プレイヤーの Inventory のアイテム配列に、リンゴが表示されるはずです。

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

仮想通貨でサポートされたアイテムを持つカタログを取得したら、以下で経済に色を付けることができます。
  • 実世界の購入: PlayFab、Unity IAP、Android の使い始め および 非レシート支払処理 チュートリアルでは、仮想経済を既存のストアと接続する方法を説明します。
  • カタログの活用: バンドル、コンテナ、ドロップ テーブルを作成します。詳細については、カタログ のチュートリアルを参照してください。
  • アイテム属性の使用: 複数の価格を定義し、スタック可能、取引可能、限定版の アイテム を指定します。
  • ユニークなゲーム内ベンダーやセール イベントのセットアップ: ストアとセール を使用します。
  • プレイヤー セグメントを作成してストアを使用する: ゲーム ライフサイクルのどこにいるかに関係なく、異なるアイテムやバンドルのオファーをプレイヤーに提供します。例については、プレイヤー セグメント向けのカスタム ストア チュートリアルを参照してください。
  • 経済データの収集: PlayFab の レポート を使用してゲームを改善および反復できるようにします。
最終更新日 2026年8月13日