> ## 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 (Legacy) でプレイヤーの Value-to-Date (VTD) を取得する

> GetPlayerProfile を使用して PlayFab プレイヤーの生涯消費を取得し、PlayerProfileModel から totalValueToDateInUSD と valuesToDate を読み取ります。

# プレイヤーの Value-to-Date (VTD) の取得 (Legacy 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 を呼び出すことで取得できる [プレイヤー プロファイル モデル](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#playerprofilemodel) の中で、プレイヤーが費やした合計金額を追跡します。

`PlayerProfileModel` 内では、プレイヤーの VTD は 2 つの異なるフィールドで追跡されます。

1. `totalValueToDateInUSD` - プレイヤーがリアル マネー通貨で行った購入の合計を、米ドル (**USD**) 換算し、セント単位 (1/100 USD) の整数値として表したものです。
2. `valuesToDate` - [ValueToDateModel](xref:titleid.playfabapi.com.client.accountmanagement.getplayerprofile#valuetodatemodel) オブジェクトの配列で、プレイヤーが購入を行った各リアル マネー通貨で合計されたプレイヤーの生涯購入合計が含まれます。各オブジェクトの `TotalValue` フィールドは、その通貨の合計を 1/100 通貨単位の整数値で表します。

次の JSON は、これら 2 つのフィールドを例の値と共に示しています。

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

## VTD を使用してプレイヤー セグメントを定義する

PlayFab Game Manager では、totalValueToDateInUSD または valuesToDate を、プレイヤー セグメントの定義に使用できる基準 (*セグメント述語*) として使用できます。

プレイヤー セグメントを作成または編集する際、ドロップダウン リストに次の 2 つの述語が含まれます。

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="Create a Segment - Mid Rollers - Filter 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="Create a Segment - Mid Rollers - Filter 2" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/create-segment-mid-rollers-filter-2.png" />


## Related topics

- [ユーザー生成コンテンツ (UGC) クイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/ugc/quickstart.md)
- [プレイヤー インベントリのクイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [チュートリアル プレイヤープロファイルの取得](/ja-jp/services/playfab/player-progression/player-data/getting-player-profiles.md)
- [PFGetPlayerCombinedInfoRequestParams](/ja-jp/services/playfab/api-references/c/pftypes/structs/pfgetplayercombinedinforequestparams.md)
- [Economy (Legacy) のプレイヤー セグメント向けカスタム ストア](/ja-jp/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)