> ## 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 v2 の実際の通貨価格

> PlayFab Economy v2 のカタログ アイテムに RealMoneyPriceDetails を構成して、マーケットプレイスごとの価格設定を行い、Apple、Google、Steam からの収益を追跡します。

# 実際の通貨価格

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

実際の通貨価格を使用すると、マーケットプレイスごとに実世界の通貨の値をカタログ アイテムに関連付けることができます。カタログ アイテムの `RealMoneyPriceDetails` プロパティには、サポートされている各マーケットプレイスごとに個別の価格ディクショナリが含まれます。このデータは、PlayFab がマーケットプレイス取引からの収益を追跡するために使用します。

## 概要

プレイヤーが外部マーケットプレイス (Apple App Store、Google Play、Steam、Microsoft Store、Nintendo eShop、PlayStation Store) を通じてアイテムを購入する場合、取引には実世界の金銭が関与します。カタログ アイテムに `RealMoneyPriceDetails` を設定することで、PlayFab は次のことができます。

* [marketplace\_transaction\_redeemed](/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed) イベントで、マーケットプレイスの引き換えからの **収益を追跡** します。

## 形式

`RealMoneyPriceDetails` は、サポートされる各マーケットプレイスごとに個別の価格ディクショナリを持つオブジェクトです。

| プロパティ                    | 型                         | 説明                              |
| :----------------------- | :------------------------ | :------------------------------ |
| `AppleAppStorePrices`    | `Dictionary<string, int>` | 通貨コードごとの Apple App Store の価格。   |
| `GooglePlayPrices`       | `Dictionary<string, int>` | 通貨コードごとの Google Play の価格。       |
| `MicrosoftStorePrices`   | `Dictionary<string, int>` | 通貨コードごとの Microsoft Store の価格。   |
| `NintendoEShopPrices`    | `Dictionary<string, int>` | 通貨コードごとの Nintendo eShop の価格。    |
| `PlayStationStorePrices` | `Dictionary<string, int>` | 通貨コードごとの PlayStation Store の価格。 |
| `SteamPrices`            | `Dictionary<string, int>` | 通貨コードごとの Steam の価格。             |

各ディクショナリは、3 文字の [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) 通貨コードを、**最小通貨単位** の価格 (たとえば USD の場合はセント) にマッピングします。

<Note>
  現在、通貨コードとしては **米ドル (USD)** のみがサポートされています。
</Note>

タイトルに関連するマーケットプレイス プロパティのみを設定する必要があります。たとえば、ゲームが Google Play と Apple App Store のみで提供されている場合、設定が必要なのは `GooglePlayPrices` と `AppleAppStorePrices` のみです。

### 価格の例

| 実世界の価格     | ディクショナリ値       |
| :--------- | :------------- |
| \$0.99 USD | `{"USD": 99}`  |
| \$1.39 USD | `{"USD": 139}` |
| \$4.99 USD | `{"USD": 499}` |
| \$9.99 USD | `{"USD": 999}` |

## カタログ アイテムへの実際の通貨価格の設定

実際の通貨価格は通常、`AlternateIds` を介して外部マーケットプレイス製品にリンクされた **バンドル** に設定します。プレイヤーがマーケットプレイスでの購入を引き換えると、PlayFab は一致するカタログ バンドルの `RealMoneyPriceDetails` の値を使用して収益を記録します。

### API

`CreateDraftItem` または `UpdateDraftItem` を使用してカタログ アイテムを作成または更新する際に、`RealMoneyPriceDetails` を設定できます。

```json theme={null}
{
  "Item": {
    "Type": "bundle",
    "Title": {
      "NEUTRAL": "Starter Pack"
    },
    "ItemReferences": [
      {
        "Id": "{{LaserSwordID}}",
        "Amount": 1
      },
      {
        "Id": "{{GoldCurrencyID}}",
        "Amount": 500
      }
    ],
    "RealMoneyPriceDetails": {
      "GooglePlayPrices": {
        "USD": 499
      },
      "AppleAppStorePrices": {
        "USD": 499
      },
      "SteamPrices": {
        "USD": 499
      }
    },
    "AlternateIds": [
      {
        "Type": "GooglePlay",
        "Value": "com.mygame.starterpack"
      },
      {
        "Type": "AppleAppStore",
        "Value": "com.mygame.starterpack"
      },
      {
        "Type": "Steam",
        "Value": "starterpack_001"
      }
    ]
  },
  "Publish": true
}
```

ストアごとに価格が異なる場合は、マーケットプレイスごとに異なる価格を設定することもできます。

```json theme={null}
"RealMoneyPriceDetails": {
  "GooglePlayPrices": {
    "USD": 499
  },
  "AppleAppStorePrices": {
    "USD": 529
  },
  "MicrosoftStorePrices": {
    "USD": 499
  }
}
```

### Game Manager

1. **Economy** > **Catalog (V2)** に移動します。
2. **Bundles** タブで、編集したいバンドルを選択するか、新しいバンドルを作成します。
3. **Prices** セクションで、各マーケットプレイスの実際の通貨価格を構成します。
4. **Marketplace Mapping** セクションで、バンドルを外部マーケットプレイス製品にリンクします。

***

## イベントに実際の通貨価格が表示される仕組み

マーケットプレイス取引が引き換えられると、対応するマーケットプレイスの価格が [marketplace\_transaction\_redeemed](/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed) イベントに `RealMoneyPrices` として含まれます。たとえば、Google Play の引き換えの場合は次のようになります。

```json theme={null}
{
  "Marketplace": "GooglePlay",
  "MarketplaceTransctionId": "GPA.1234-5678-9012-34567",
  "MarketplaceAlternateId": "com.mygame.starterpack",
  "Amount": 1,
  "ItemId": "{{BundleID}}",
  "ItemType": "bundle",
  "RealMoneyPrices": {
    "USD": 499
  }
}
```

このイベント データは、次の用途に使用できます。

* Insights Explorer を介したカスタム分析クエリ

## ベスト プラクティス

* **マーケットプレイス バンドルには必ず `RealMoneyPriceDetails` を設定してください。** これにより、正確な収益追跡と分析が保証されます。
* **最小通貨単位を使用してください。** USD の場合、価格をセント単位で指定します (たとえば \$4.99 の場合は `499`)。
* **使用するマーケットプレイスのみを設定してください。** すべてのマーケットプレイスに価格を設定する必要はありません。タイトルが公開されているものだけで十分です。
* **マーケットプレイスのリストと価格を同期してください。** 外部マーケットプレイスで価格を更新する際は、`RealMoneyPriceDetails` の対応するプロパティも更新して、正確なレポートを維持してください。
* **価格が異なる場合はマーケットプレイスごとに設定してください。** ストアごとにゲームの価格が異なる場合は、マーケットプレイスごとのプロパティを使用して、各プラットフォームの実際の価格を反映させます。

## 関連項目

* [Economy v2 バンドル](/services/playfab/economy-monetization/economy-v2/catalog/bundles)
* [ストア](/services/playfab/economy-monetization/economy-v2/catalog/stores)
* [不正防止のクイックスタート](/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart)
* [マーケットプレイス統合](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/overview)
* [marketplace\_transaction\_redeemed イベント](/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed)


## Related topics

- [Economy v2 での実際の通貨価格の追跡](/ja-jp/services/playfab/economy-monetization/economy-v2/tutorials/real-money-price-tracking.md)
- [XR-036 タイトル内の価格情報](/ja-jp/publishing/certification/xr/xr-036.md)
- [Economy v2 カタログ コンテンツ タイプ、タグ、プロパティ](/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [クイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Economy (レガシー) のクイックスタート](/ja-jp/services/playfab/economy-monetization/economy/quickstart.md)