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

# items_purchased

> ItemsPurchased event.

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

## 属性

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

## 通用属性

所有 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)     | 此事件所应用于的实体的详细信息，包括 Entity Id 和 Entity type。 |
| Originator         | [Object](/services/playfab/api-references/events/data-types/originatorobject) | 描述发起此事件的来源和来源类型的对象。                         |
| PayloadContentType | String                                                                        | 指定事件负载的内容。默认为 "JSON"。                       |
| Origin Info        | Object                                                                        | 可选字段，包含来自 PlayFab 外部的事件的相关信息。               |


## Related topics

- [item_purchased](/zh-CN/services/playfab/api-references/events/CatalogV2/item-purchased.md)
- [PlayFab 的 PlayStream 事件模型参考](/zh-CN/services/playfab/api-references/events/index.md)
- [使用玩家自定义属性进行高级分段](/zh-CN/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.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)