> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# items_purchased

> ItemsPurchased event.

从库存中购买物品时引发的事件。

## 属性

| 名称 | 类型 | 说明 |
| :- | :- | :- |
| TransactionId | String | 交易 ID。 |
| CollectionId | String | 集合 ID。 |
| ItemId | String | 物品 ID。 |
| StackId | String | 堆栈 ID。 |
| Amount | int? | 购买的物品数量。 |
| DurationInSeconds | long? | 购买的物品的持续时间。 |
| SalePriceAmounts | List\<[PurchasePriceAmount](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/purchasepriceamount.md)> | 物品被购买时的每件价格金额。 |
| StoreId | String | 物品所在商店的 ID，如果不适用则为 null。 |
| ItemType | String | 交易中修改的目录物品的类型。 |
| Balance | int? | 因交易而更改的物品余额。 |

## 通用属性

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

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


## Related topics

- [item_purchased](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/CatalogV2/item-purchased.md)
- [PlayStream 事件模型参考](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/index.md)
- [使用玩家自定义属性进行高级分段](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)
- [ItemPurchasedCurrency](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/itempurchasedcurrency.md)
- [ItemPurchasedOverride](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/itempurchasedoverride.md)