> ## 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(Value-to-Date) 가져오기

> GetPlayerProfile을 사용해 PlayFab 플레이어의 평생 지출을 검색하고 PlayerProfileModel에서 totalValueToDateInUSD 및 valuesToDate를 읽습니다.

# 플레이어의 VTD(Value-to-Date) 가져오기(레거시 Economy)

<Info>
  Economy v1 API는 유지 관리 모드에 있으며 새 기능은 제공되지 않고 버그 수정만 이루어집니다. **v1 API는 예측 가능한 미래 동안 유지됩니다.** 다음 버전의 PlayFab Economy에 대해 자세히 알아보려면 [Economy v2 개요](/services/playfab/economy-monetization/economy-v2/overview)를 참조하세요!
</Info>

PlayFab은 [GetPlayerProfile](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile) API를 호출하여 검색되는 [player profile model](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#playerprofilemodel)에서 플레이어의 총 지출액을 추적합니다.

`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="세그먼트 만들기 - Mid Rollers - 필터 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="세그먼트 만들기 - Mid Rollers - 필터 2" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-2.png" />


## Related topics

- [Economy(레거시) 빠른 시작](/ko/services/playfab/economy-monetization/economy/quickstart.md)
- [아이템(레거시 Economy) 빠른 시작](/ko/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Economy(레거시)에서의 시간 제한 소모품](/ko/services/playfab/economy-monetization/economy/tutorials/timed-consumables.md)
- [스토어(Economy 레거시) 빠른 시작](/ko/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [Economy(레거시)에서의 플레이어 세그먼트용 사용자 지정 스토어](/ko/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)