Economy (Legacy) でプレイヤーの Value-to-Date (VTD) を取得する

プレイヤーの Value-to-Date (VTD) の取得 (Legacy Economy)

Economy v1 API はメンテナンスモードにあり、新機能は追加されず、バグ修正のみが行われます。v1 API は当面の間、維持されます。 PlayFab Economy の次のバージョンの詳細については、Economy v2 の概要を参照してください。

PlayFab は、GetPlayerProfile API を呼び出すことで取得できるプレイヤープロファイルモデルの中で、プレイヤーが費やした合計金額を追跡します。

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

totalValueToDateInUSD - プレイヤーがリアルマネー通貨で行った購入の合計を、米ドル (USD) 換算し、セント単位 (1/100 USD) の整数値として表したものです。

valuesToDate - ValueToDateModel オブジェクトの配列で、プレイヤーが購入を行った各リアルマネー通貨で合計されたプレイヤーの生涯購入合計が含まれます。各オブジェクトの TotalValue フィールドは、その通貨の合計を 1/100 通貨単位の整数値で表します。

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

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

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

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

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

Total value to date in USD - TotalValueToDateInUSD 値。

Value to date - ValuesToDate の合計。この述語を選択すると、通貨とその通貨の金額を指定する追加フィールドが表示されます。

セグメントの例

以下の例は、各 VTD 合計を使用して作成されたセグメントを示しています。

任意の通貨で 15 USD を超える金額を購入したすべてのプレイヤーのセグメントを作成します。

任意の通貨で 15 USD を超える または 15 中国元 を超える金額を費やしたすべてのプレイヤーのセグメントを作成します。

​プレイヤーの Value-to-Date (VTD) の取得 (Legacy Economy)