Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、PlayFab フォーラム を参照してください。
RealMoneyPriceDetails を構成することで、PlayFab は marketplace_transaction_redeemed イベントに収益額を記録し、収益分析とレポートを構築できるようにします。
このチュートリアルでは、エンドツーエンドのフローを説明します。バンドルに実際の通貨価格を設定し、購入を引き換え、イベントで収益データを表示します。
前提条件
- PlayFab 開発者アカウント。
- Game Manager で作成されたタイトル。
- すでに構成されたマーケットプレイス統合 (たとえば、Google、Apple、または Microsoft Store)。
- マーケットプレイス製品にリンクする マーケットプレイス マッピング を持つ公開済みバンドル。
ステップ 1: バンドルに実際の通貨価格を設定する
マーケットプレイス製品にリンクされているバンドルにRealMoneyPriceDetails を追加します。マーケットプレイスごとに 最小通貨単位 (たとえば USD の場合はセント) で価格を指定します。
API
UpdateDraftItem を使用して既存のバンドルに価格を追加し、公開します。Game Manager
- Economy > Catalog (V2) > Bundles に移動します。
- 編集するバンドルを選択します。
- Prices セクションで、バンドルが表示される各マーケットプレイスの実際の通貨価格を設定します。
- Marketplace Mapping セクションで、各マーケットプレイスに正しい AlternateId があることを確認します。
- Save and publish を選択します。
価格形式リファレンス
価格は最小通貨単位を使用します。現在は USD のみサポートされています。
タイトルが使用するマーケットプレイスにのみ価格を設定します。サポートされているマーケットプレイス プロパティは次のとおりです。
AppleAppStorePricesGooglePlayPricesMicrosoftStorePricesNintendoEShopPricesPlayStationStorePricesSteamPrices
マーケットプレイスごとに異なる価格
ストアごとにゲームの価格が異なる場合、各マーケットプレイス プロパティを個別に設定します。ステップ 2: プレイヤーが購入して引き換える
プレイヤーが外部マーケットプレイスからアイテムを購入した後、ゲームは適切な redeem API を呼び出します。
PlayFab は引き換えを処理する際、次を行います。
- マーケットプレイスのレシートをバンドルの
AlternateIdと照合します。 - バンドルの内容をプレイヤーのインベントリに付与します。
- 一致するバンドルの
RealMoneyPricesを含むmarketplace_transaction_redeemedイベントを発行します。
ステップ 3: イベントで収益を表示する
引き換えが成功すると、marketplace_transaction_redeemed イベントが発行され、実際の通貨価格データが含まれます。このイベントは Game Manager で確認するか、データ パイプラインを通じてクエリできます。
Game Manager で表示する
- Data > Event History に移動します (Analyze セクションの下)。
marketplace_transaction_redeemedイベント名を検索します。- イベントを選択して、
RealMoneyPricesフィールドを含むその詳細を表示します。
イベント ペイロードの例
Starter Pack ($4.99 USD) の Google Play 引き換えは、次のようなイベントを生成します。収益データをクエリする
イベント データはカスタム分析に使用できます。たとえば、一定期間の総収益を計算するには、すべてのmarketplace_transaction_redeemed イベントをクエリし、RealMoneyPrices.USD の値を合計します。
RealMoneyPrices は、RealMoneyPriceDetails で構成した内容を反映し、マーケットプレイスによって実際に課金された金額ではありません。正確なレポートのために、マーケットプレイスのリストと価格を同期させておいてください。ベスト プラクティス
- マーケットプレイス バンドルには必ず
RealMoneyPriceDetailsを設定してください。 これがないと、引き換えイベントのRealMoneyPricesフィールドは空になり、収益の可視性が失われます。 - 最小通貨単位を使用してください。 USD の場合、価格をセント単位で指定します (たとえば $4.99 の場合は
499)。 - 使用するマーケットプレイスのみを設定してください。 すべてのマーケットプレイスに価格を設定する必要はありません。タイトルが公開されているものだけで十分です。
- マーケットプレイスのリストと価格を同期してください。 外部マーケットプレイスで価格を更新する際は、
RealMoneyPriceDetailsの対応するプロパティも更新して、正確なレポートを維持してください。 - 価格が異なる場合はマーケットプレイスごとに設定してください。 ストアごとにゲームの価格が異なる場合は、マーケットプレイスごとのプロパティを使用して、各プラットフォームの実際の価格を反映させます。