Economy v2 現已正式推出。如需支援和意見反應，請前往 PlayFab 論壇。
RealMoneyPriceDetails，PlayFab 會在 marketplace_transaction_redeemed 事件中記錄營收金額，讓您能夠建置營收分析和報告。
本教學課程會逐步引導您完成端對端流程：在組合上設定真實貨幣價格、兌換購買項目，以及在事件中檢視營收資料。
必要條件
- PlayFab 開發人員帳戶。
- 在 Game Manager 中建立的遊戲。
- 已設定的市集整合 (例如 Google、Apple 或 Microsoft Store)。
- 已發佈的組合，且具有將其連結至市集產品的 Marketplace Mapping。
步驟 1：在組合上設定真實貨幣價格
將RealMoneyPriceDetails 新增至連結到市集產品的組合。依市集以最小貨幣單位 (例如，美元使用美分) 指定價格。
API
使用 UpdateDraftItem 將價格新增至現有組合，然後加以發佈：Game Manager
- 前往 Economy > Catalog (V2) > Bundles。
- 選取要編輯的組合。
- 在 Prices 區段中，為組合出現的每個市集設定真實貨幣價格。
- 確定 Marketplace Mapping 區段中每個市集的 AlternateIds 都正確。
- 選取 Save and publish。
價格格式參考
價格使用最小貨幣單位。目前僅支援 USD。
只為您的遊戲使用的市集設定價格。支援的市集屬性如下：
AppleAppStorePricesGooglePlayPricesMicrosoftStorePricesNintendoEShopPricesPlayStationStorePricesSteamPrices
每個市集設定不同價格
如果您在各商店為遊戲設定不同的價格，請個別設定每個市集屬性：步驟 2：玩家進行購買並兌換
玩家從外部市集購買物品後，您的遊戲會呼叫適當的兌換 API：
當 PlayFab 處理兌換時，它會：
- 將市集收據與組合的
AlternateId進行比對。 - 將組合的內容授與至玩家的庫存。
- 發出
marketplace_transaction_redeemed事件，其中包含來自相符組合的RealMoneyPrices。
步驟 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中對應的屬性，以維持準確的報告。 - 價格不同時，請依市集設定價格。 如果您的遊戲在各商店的定價不同，請使用各市集屬性來反映每個平台上的實際價格。