取得玩家的累計價值 (VTD) (舊版 Economy)

Economy v1 API 處於維護模式，不會再推出任何新功能，只會修正錯誤。**v1 API 在可預見的未來仍會持續維護。**請參閱 Economy v2 概觀，深入了解下一版的 PlayFab Economy！

PlayFab 會在玩家設定檔模型中追蹤玩家花費的總金額，您可以透過呼叫 GetPlayerProfile API 來擷取該模型。在 PlayerProfileModel 中，玩家的 VTD 會在兩個不同的欄位中追蹤：

totalValueToDateInUSD - 玩家以真實貨幣進行之購買的總和，換算為等值美元 (USD)，並以整數的美分 (1/100 USD) 表示。
valuesToDate - ValueToDateModel 物件的陣列，其中包含玩家的終身購買總額，依玩家曾用來購買的每種真實貨幣分別加總。每個物件中的 TotalValue 欄位會以 1/100 貨幣單位的整數表示該貨幣的總額。

下列 JSON 顯示這兩個欄位與範例值。

{
    …
    totalValueToDateInUSD: 1700
    valuesToDate: [{ "USD", 1200 }, { "EUR", 320 }]
    …
}

使用 VTD 定義玩家區段

在 PlayFab Game Manager 中，您可以使用 totalValueToDateInUSD 或 valuesToDate 作為區段述詞，也就是可用來定義玩家區段的準則。建立或編輯玩家區段時，下拉式清單中會包含這兩個述詞：

下列範例顯示使用各個 VTD 總額建立的區段。

最後修改於 2026年10月6日

⌘I