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

# item_purchased

> item_purchased 事件。

购买物品时触发此事件。

## 属性

| 名称                    | 类型                                                                                                       | 说明                    |
| :-------------------- | :------------------------------------------------------------------------------------------------------- | :-------------------- |
| CollectionId          | String                                                                                                   | 物品被添加到的集合的 ID。        |
| Currencies            | List\<[ItemPurchasedCurrency](/services/playfab/api-references/events/data-types/itempurchasedcurrency)> | 用于支付物品的货币集合。          |
| IdempotencyId         | String                                                                                                   | 幂等 ID。                |
| ItemId                | String                                                                                                   | 已购物品的 ID。             |
| ItemsAmountsOverrides | List\<[ItemPurchasedOverride](/services/playfab/api-references/events/data-types/itempurchasedoverride)> | 用于更改物品数量的覆盖集合。        |
| ItemType              | String                                                                                                   | 已购物品的类型。              |
| OverrideSource        | String                                                                                                   | 购买中使用的覆盖的来源。          |
| PayoutAmountOverride  | [ItemPurchasedOverride](/services/playfab/api-references/events/data-types/itempurchasedoverride)        | 用于更改购买支付金额的覆盖。        |
| PriceAmountsOverrides | List\<[ItemPurchasedOverride](/services/playfab/api-references/events/data-types/itempurchasedoverride)> | 用于更改购买价格的覆盖集合。        |
| Quantity              | uint64                                                                                                   | 已购物品的数量。              |
| StoreId               | String                                                                                                   | 商店的可选 ID。             |
| TransactionDateTime   | String                                                                                                   | 交易时间戳，采用 ISO-8601 格式。 |
| TransactionId         | String                                                                                                   | 添加此物品的交易 ID。          |

## 通用属性

所有 V2 PlayStream 事件均格式化为 JSON 对象，并且大多数事件共享以下通用属性：

| 名称                 | 类型                                                                            | 说明                             |
| :----------------- | :---------------------------------------------------------------------------- | :----------------------------- |
| SchemaVersion      | String                                                                        | PlayStream 事件格式版本，遵循语义化版本控制方案。 |
| FullName           | [Object](/services/playfab/api-references/events/data-types/fullnameobject)   | 事件名称和事件命名空间的组合，用于完全指定事件类型。     |
| Id                 | String                                                                        | PlayFab 为此事件分配的唯一标识符。          |
| Timestamp          | DateTime                                                                      | 与此事件关联的时间（UTC）。                |
| Entity             | [Object](/services/playfab/api-references/events/data-types/entityobject)     | 与此事件相关的实体的详细信息，包括实体 ID 和实体类型。  |
| Originator         | [Object](/services/playfab/api-references/events/data-types/originatorobject) | 描述发起此事件的来源和来源类型的对象。            |
| PayloadContentType | String                                                                        | 指定事件负载的内容。默认为 "JSON"。          |
| Origin Info        | Object                                                                        | 可选字段，包含关于源自 PlayFab 外部的事件的信息。  |


## Related topics

- [items_purchased](/zh-CN/services/playfab/api-references/events/Inventory/items-purchased.md)
- [PlayFab 的 PlayStream 事件模型参考](/zh-CN/services/playfab/api-references/events/index.md)
- [ItemPurchasedCurrency 数据类型](/zh-CN/services/playfab/api-references/events/data-types/itempurchasedcurrency.md)
- [ItemPurchasedOverride 数据类型](/zh-CN/services/playfab/api-references/events/data-types/itempurchasedoverride.md)
- [character_vc_item_purchased](/zh-CN/services/playfab/api-references/events/Character/character-vc-item-purchased.md)