Economy v2 现已正式发布。如需支持和反馈,请访问 PlayFab 论坛。
RealMoneyPriceDetails,PlayFab 会在 marketplace_transaction_redeemed 事件中记录收入金额,使你能够构建收入分析和报告。
本教程将引导你完成端到端的流程:在捆绑包上设置真钱价格、兑换购买,并在事件中查看收入数据。
先决条件
- 一个 PlayFab 开发者账户。
- 在 Game Manager 中创建的 title。
- 已配置的市场集成(例如 Google、Apple 或 Microsoft Store)。
- 一个已发布的捆绑包,其市场映射 将其链接到市场产品。
步骤 1:在你的捆绑包上设置真钱价格
将RealMoneyPriceDetails 添加到链接到你的市场产品的捆绑包。以每个市场的最小货币单位(例如 USD 的美分)指定价格。
API
使用 UpdateDraftItem 向现有捆绑包添加价格,然后发布它:Game Manager
- 转到 Economy > Catalog (V2) > Bundles。
- 选择要编辑的捆绑包。
- 在 Prices 部分,为捆绑包出现的每个市场设置真钱价格。
- 确保 Marketplace Mapping 部分具有每个市场的正确 AlternateIds。
- 选择 Save and publish。
价格格式参考
价格使用最小货币单位。目前仅支持 USD。
仅为你的 title 使用的市场设置价格。支持的市场属性为:
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,请提供以美分为单位的价格(例如,
499表示 $4.99)。 - 仅填充你使用的市场。 你不需要为每个市场设置价格——仅为你的 title 发布所在的市场设置。
- 保持价格与你的市场列表同步。 当你在外部市场中更新价格时,请更新
RealMoneyPriceDetails中相应的属性以保持准确的报告。 - 当价格不同时,按市场设置价格。 如果你的游戏在各商店中定价不同,请使用按市场的属性来反映每个平台上的实际价格。
