実際の通貨価格

Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、PlayFab フォーラムを参照してください。

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

概要

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

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 通貨コードを、最小通貨単位 の価格 (たとえば USD の場合はセント) にマッピングします。

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

タイトルに関連するマーケットプレイスプロパティのみを設定する必要があります。たとえば、ゲームが 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 を設定できます。

{
  "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
}

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

"RealMoneyPriceDetails": {
  "GooglePlayPrices": {
    "USD": 499
  },
  "AppleAppStorePrices": {
    "USD": 529
  },
  "MicrosoftStorePrices": {
    "USD": 499
  }
}

Game Manager

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

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

マーケットプレイス取引が引き換えられると、対応するマーケットプレイスの価格が marketplace_transaction_redeemed イベントに RealMoneyPrices として含まれます。たとえば、Google Play の引き換えの場合は次のようになります。

{
  "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 の対応するプロパティも更新して、正確なレポートを維持してください。
価格が異なる場合はマーケットプレイスごとに設定してください。 ストアごとにゲームの価格が異なる場合は、マーケットプレイスごとのプロパティを使用して、各プラットフォームの実際の価格を反映させます。

XBOX Services

PlayFab

Economy v2 の実際の通貨価格

実際の通貨価格

概要

形式

価格の例

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

API

Game Manager

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

ベストプラクティス

関連項目

​実際の通貨価格

​概要

​形式

​価格の例

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

​API

​Game Manager

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

​ベスト プラクティス

​関連項目

実際の通貨価格

概要

形式

価格の例

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

API

Game Manager

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

ベストプラクティス

関連項目