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

# Economy v2 の概要

> べき等な取引、バッチ操作、大規模なカタログ、大規模タイトル向けのインベントリ サポートなど、PlayFab Economy v2 のアーキテクチャを紹介します。

> [!NOTE]
>
> Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、[PlayFab フォーラム](https://community.playfab.com) を参照してください。

Economy v2 は、既存の PlayFab Monetization スイートの機能からの大きな変更です。この変更の目標は、数億人のアクティブ プレイヤー、大規模な進行システム、巨大なインベントリを持つタイトルをサポートすることです。アーキテクチャは、最新の Azure Stack を基にゼロから再構築されています。これは、以下の機能に関連する開発者のニーズを対象としています。

* べき等な取引
* バッチ操作
* 特にインベントリの相互作用における、高い [同時実行](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/etags.md) レートの処理
* ゲーム内商品またはユーザー生成コンテンツ (UGC) の大規模な統合カタログ (エンティティごとに最大 20 GB) で、複数のエンティティをサポート
* すべてのアイテムを 1 つのドキュメントに格納するのではなく、個別のカタログ アイテム ドキュメント
* 大規模なプレイヤー インベントリ ([数千のアイテム](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/limits.md))
* PlayFab エンティティとの統合

Economy v2 は、他の PlayFab サービスに期待するのと同じ柔軟性と拡張性を持って設計されています。アーキテクチャは PlayFab にとっては新しいものですが、実戦テスト済みで、**Minecraft**、**Sea of Thieves**、**Flight Simulator** などの Microsoft の内部タイトルをサポートしています。

私たちがなぜ Economy v2 を作成したのか、そしてそのタイトルにどのように改善を活用できるのかについて興味がありますか?

[https://www.youtube.com/embed/NcvFFgTZ6ek](https://www.youtube.com/embed/NcvFFgTZ6ek)

## どのバージョンの Economy を使用すべきですか?

バージョン 2 を使用してください。バージョン 1 を使用している場合は、アップグレードを検討してください。Microsoft は v1 を非推奨にはしておらず、すべてのタイトルに対して維持およびサポートを続けますが、バグ修正のみのモードです。新しい Economy 機能はバージョン 2 でのみ開発されます。2 つのバージョンの違いの詳細については、[FAQ](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/faq.md) を参照してください。

## Economy v2 の新機能

Economy v2 では、v1 では利用できなかったいくつかの新機能が導入されています。

* [インベントリ](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/inventory.md) とカタログ間の更新された相互作用により、一意のアイテム、非一意のアイテム、アイテムのスタック、およびアイテムの複数のスタックをサポートできます。
* カタログ アイテムと共に、画像やファイルなどの [メタデータ](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md) およびコンテンツをアップロードして管理できます。
* Economy の設定を使用して、ゲーム コンテンツへの [ディープ リンク](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/deep-links.md) を作成できます。
* カスタマイズ可能な [カタログ検索](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/search.md) により、タグとコンテンツ タイプを使用したカスタム ビューをセットアップできます。
* アイテムの説明とタイトルを [ローカライズ](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/localization.md) するシンプルな方法。
* PlayerEntity 向けの [アイテム評価とレビュー](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/ratings.md) をサポートする API。
* [下書き状態を使ったオーサリング](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/item-status.md) や [カタログ管理者およびレビュー担当者向けのポリシー権限セット](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/settings.md) など、カスタム ワークフローのサポート。将来の開始日でカタログ アイテムを事前公開できます。
* 複数の外部マーケットプレース アイテムにリンクできる [バンドル アイテム](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/bundles.md)。
* 単一プレイヤーが、キャラクターごとまたはプラットフォームごとなど、複数のインベントリを持てるようにする [インベントリ コレクション](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/collections.md)。
* 1 つのインベントリ内に、それぞれ独自の数量とプロパティを持つ同じアイテムの複数の異なるインスタンスを可能にする [インベントリ スタック](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/stacks.md)。
* インベントリ全体 (最大 10,000 アイテム) を単一の圧縮された API 呼び出しで読み込み、起動を高速化する [TurboLoading](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/turboloading.md)。
* 組み込みのモデレーション パイプラインを使用して、プレイヤーがモデレートされたコンテンツを作成、アップロード、検索できるようにする [ユーザー生成コンテンツ (UGC)](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/ugc/overview.md)。
* [ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations) は、単一のリクエストでインベントリ操作をアトミックにバッチ処理します。いずれかの操作が失敗すると、バッチ全体がロールバックされます。
* カタログとインベントリの更新に対して楽観的同時実行制御を提供し、競合状態を防ぐ [ETags](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/etags.md)。
* Apple、Google、Steam、Nintendo、PlayStation Store、Microsoft Store の各マーケットプレースにわたる組み込みの [不正防止とレシート検証](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/fraud-prevention.md)。
* 異なるプレイヤー グループに合わせた動的価格設定を伴うセグメント限定ストアを可能にする [ターゲット オファー](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers.md)。

## v1 からの変更点

役立たせるには制限が厳しすぎた Economy の機能は、v2 に含まれませんでした。この制限を解消するため、製品チームは CloudScript の強化された後継として Azure Functions を発表しました。チームはまた、独自のカスタム実装の出発点として、レシピ スタイルのドキュメントも提供しました。次に、製品チームは、最も重要だと皆さんが伝えたことに焦点を当てました。

以下の v1 の機能は、Economy v2 のネイティブなアイテム タイプとして含まれていません。一部の機能は v2 の構成要素を使用して部分的に再現できますが、他の機能は [Azure Functions](https://learn.microsoft.com/en-us/azure/azure-functions/functions-overview) を通じたカスタム ロジックが必要です。

### 部分的にサポート

これらの v1 機能は、既存の v2 API と構成要素を使用して実現できます。

* **アイテムの変換**: [ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations) API を使用してアイテム変換 (クラフト) を実現できます。この API は、単一のリクエストで入力アイテムをアトミックに減算し、結果を追加します。例については、[クラフト ゲームのチュートリアル](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/game-context.md) を参照してください。
* **コンテナ (固定コンテンツ)**: [バンドルと仮想通貨](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/tutorials/containers-with-fixed-contents.md) を使用して、常に同じアイテムを付与するコンテナを実装できます。通貨トークンがコンテナを表し、1 つのトークンで価格設定されたバンドルを購入するとコンテンツが付与されます。

### サポートされていない

これらの v1 機能には v2 でのネイティブな相当機能がなく、カスタム ロジック (たとえば Azure Functions を使用) が必要です。

* **取引**: V1 は、プレイヤー間のアトミックな双方向アイテム スワップを提供していました。V2 にはネイティブな取引 API はありません。プレイヤー同士の取引を実装するには、[Azure Functions](https://learn.microsoft.com/en-us/azure/azure-functions/functions-overview) を使用したカスタム オーケストレーションが必要です。
* **限定アイテム**: V1 では、有限のグローバル供給を持つカタログ アイテムをサポートしていました。V2 では、グローバルな数量上限を追跡および強制するためにサーバー側のロジックが必要です。
* **ドロップ テーブル**: V1 には重み付けランダム ルート テーブルが組み込まれていました。V2 では、Azure Functions を使用してカスタムのランダム選択ロジックが必要です。完全な実装については、[ドロップ テーブルとランダム化されたルートのチュートリアル](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/tutorials/drop-tables-and-randomized-loot.md) を参照してください。
* **コンテナ (ランダム化)**: ドロップ テーブルと組み合わせた V1 のコンテナは、開封時にランダムなアイテムを付与しました。V2 では、コンテナを減算してランダムに選択されたアイテムを付与するためのカスタム ロジックが必要です。[ドロップ テーブルとランダム化されたルートのチュートリアル](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/tutorials/drop-tables-and-randomized-loot.md) を参照してください。
* **再充填レート**: V1 では、時間の経過と共に再生される使用回数を持つアイテムを許可していました。V2 では、再生される数量を計算して付与するために、カスタムの時間ベースのロジックが必要です。
* **セグメントに対するストア サポート**: V1 では、プレイヤー セグメントとストアの間の自動リンクが可能でした。V2 は [ストア](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/stores.md) と [セグメント](https://docs.xbox.com/ja-jp/services/playfab/player-progression/player-data/player-segments.md) の両方を持ち、セグメント限定ストアを備えた [ターゲット オファー](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers.md) をサポートしますが、自動割り当てを使用するのではなく、構成を手動でセットアップする必要があります。

## 関連項目

* [クイックスタート](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/quickstart.md)
* [設定](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/settings.md)
* [ストア](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/stores.md)
* [インベントリ](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/inventory.md)
* [マーケットプレース統合](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/overview.md)
* [不正防止](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/fraud-prevention.md)
* [TurboLoading](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/turboloading.md)
* [制限](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/limits.md)
* [FAQ](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/faq.md)


## Related topics

- [Economy v2 の設定の概要](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/settings.md)
- [カタログの概要](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview.md)
- [Economy V2 TurboLoading](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/turboloading.md)
- [Economy V2 のセグメント アクション](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/segment-actions.md)
- [Economy V2 のターゲット オファー](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers.md)