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

# marketplace_transaction_redeemed

> marketplace_transaction_redeemed event.

当捆绑包或订阅被兑换到库存时触发此事件。

## 属性

| 名称 | 类型 | 说明 |
| :- | :- | :- |
| Marketplace | String | 兑换物品来源的市场名称。 |
| MarketplaceTransctionId | String | 兑换物品来源市场中的交易 ID。 |
| MarketplaceAlternateId | String | 市场中物品的备用 ID。 |
| Amount | int? | 兑换的数量。 |
| DurationInSeconds | long? | 兑换的订阅数量。 |
| ItemId | String | 已兑换物品的标识符。 |
| ItemType | String | 已兑换目录物品的类型。 |
| RealMoneyPrices | Dictionary\<string, int> | 已兑换物品的多币种真实货币单价。该属性是一个字典，其中键是按照 ISO 4217 定义的三字母货币代码，值是符合 ISO 4217 的最小单位货币金额（例如分、便士）。目前仅支持美元（USD）。示例：如果产品价格为 \$1.39 美元，字典条目为：\["USD"] = 139； |

## 通用属性

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

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


## Related topics

- [Economy v2 真钱价格](https://devdocs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/real-money-prices.md)
- [Economy v2 中的真钱价格跟踪](https://devdocs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/tutorials/real-money-price-tracking.md)
- [PlayStream 事件模型参考](https://devdocs.xbox.com/zh-CN/services/playfab/api-references/events/index.md)
- [items_redeemed](https://devdocs.xbox.com/zh-CN/services/playfab/api-references/events/Inventory/items-redeemed.md)
- [使用 JWS 兑换 Apple App Store 库存物品](https://devdocs.xbox.com/zh-CN/services/playfab/api-references/rest/economy/inventory/redeem-apple-app-store-with-jws-inventory-items.md)