> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 使用 GetPlayerProfile 擷取 PlayFab 玩家的終身消費金額，並從 PlayerProfileModel 讀取 totalValueToDateInUSD 和 valuesToDate。

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

<Info>
  Economy v1 API 處於維護模式，不會再推出任何新功能，只會修正錯誤。\*\*v1 API 在可預見的未來仍會持續維護。\*\*請參閱 [Economy v2 概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/overview)，深入了解下一版的 PlayFab Economy！
</Info>

PlayFab 會在[玩家設定檔模型](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#playerprofilemodel)中追蹤玩家花費的總金額，您可以透過呼叫 [GetPlayerProfile](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile) API 來擷取該模型。

在 `PlayerProfileModel` 中，玩家的 VTD 會在兩個不同的欄位中追蹤：

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

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

```json theme={null}
{
    …
    totalValueToDateInUSD: 1700
    valuesToDate: [{ "USD", 1200 }, { "EUR", 320 }]
    …
}
```

## 使用 VTD 定義玩家區段

在 PlayFab Game Manager 中，您可以使用 totalValueToDateInUSD 或 valuesToDate 作為*區段述詞*，也就是可用來定義玩家區段的準則。

建立或編輯玩家區段時，下拉式清單中會包含這兩個述詞：

1. **Total value to date in USD** - `TotalValueToDateInUSD` 值。
2. **Value to date** - `ValuesToDate` 總額。當您選取此述詞時，會看到其他欄位，可用來指定貨幣以及該貨幣的金額。

## 區段範例

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

1. 建立所有以任何貨幣購買超過 **15 USD** 之玩家的區段。

   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-1.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=fa15a6d1b2d3ffbd840f6bb1af492501" alt="建立區段 - 中度消費者 - 篩選 1" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-1.png" />

2. 建立所有以任何貨幣花費超過 **15 USD** *或* **15 人民幣**之玩家的區段。

   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-2.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=2369e1383568c3fe81d6f8def958289e" alt="建立區段 - 中度消費者 - 篩選 2" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-2.png" />


## Related topics

- [目錄 (舊版 Economy)](/zh-TW/services/playfab/economy-monetization/economy/items/catalogs.md)
- [在 Economy (舊版) 中管理虛擬貨幣](/zh-TW/services/playfab/economy-monetization/economy/tutorials/currencies.md)
- [Economy (舊版) 中適用於玩家區段的自訂商店](/zh-TW/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)
- [Economy (舊版) 中商店分群的最佳做法](/zh-TW/services/playfab/economy-monetization/economy/tutorials/best-practices-for-store-segmentation.md)
- [流失預測定價](/zh-TW/services/playfab/data-analytics/learn-data/churn-prediction/pricing.md)