> ## 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.

# player_virtual_currency_balance_changed

> player_virtual_currency_balance_changed イベント。

このイベントは、プレイヤーの仮想通貨残高が変化したときにトリガーされます。

## Properties

| Name                           | Type   | Description                 |
| :----------------------------- | :----- | :-------------------------- |
| OrderId                        | String | 残高の変化を引き起こした注文の ID          |
| TitleId                        | String | このプレイヤー イベントが適用されるタイトルの ID。 |
| VirtualCurrencyBalance         | int32  | 変更後の新しい仮想通貨残高。              |
| VirtualCurrencyName            | String | 残高が変化した仮想通貨。                |
| VirtualCurrencyPreviousBalance | int32  | 変更前の以前の仮想通貨残高。              |

## Common Properties

すべての V1 PlayStream イベントは JSON オブジェクトとして書式設定されており、次の共通プロパティを共有します。

| Name           | Type                                                                        | Description                                                                                                                                                                                                                                               |
| :------------- | :-------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| EntityId       | String                                                                      | このイベントが適用されるエンティティ (タイトル、プレイヤーなど) の識別子。                                                                                                                                                                                                                   |
| EntityType     | String                                                                      | このイベントが適用されるエンティティのタイプ (プレイヤー、タイトルなど)。PlayFab がこのエンティティに対してアクションを実行する場合、EntityType は 'player'、'character'、または 'title' のいずれかである必要があります。PlayFab が現在解析しないエンティティ タイプには、名前空間 ('com.mygame.guild' など) を先頭に付ける必要があります。PlayFab はいつでもルート エンティティの解析を開始する可能性があるためです。 |
| EventId        | String                                                                      | このイベントに対して PlayFab から割り当てられた一意の識別子。                                                                                                                                                                                                                       |
| EventName      | String                                                                      | このイベントの名前。                                                                                                                                                                                                                                                |
| EventNamespace | String                                                                      | このイベントに割り当てられた名前空間。例: 'com.myprogram.ads'                                                                                                                                                                                                                 |
| Source         | String                                                                      | この PlayStream イベントのソースの名前。イベントが当社から発信された場合は PlayFab になります。                                                                                                                                                                                                |
| SourceType     | [SourceType](/services/playfab/api-references/events/data-types/sourcetype) | このイベントのソースのタイプ (PlayFab パートナー、その他のバックエンド、または PlayFab API から)。                                                                                                                                                                                             |
| Timestamp      | DateTime                                                                    | このイベントに関連付けられた時刻 (UTC)。                                                                                                                                                                                                                                   |


## Related topics

- [プライズ テーブルの使用](/ja-jp/services/playfab/community/leaderboards/tournaments-leaderboards/using-prize-tables.md)
- [プレイヤー セグメント全体への一括アクション](/ja-jp/services/playfab/data-analytics/acting-data/action-rules-bulk-actions-for-an-entire-player-segment.md)
- [PlayFab の PlayStream イベント モデル リファレンス](/ja-jp/services/playfab/api-references/events/index.md)
- [ストア (Economy Legacy) クイックスタート](/ja-jp/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [character_virtual_currency_balance_changed](/ja-jp/services/playfab/api-references/events/Character/character-virtual-currency-balance-changed.md)