---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://appmetrica.yandex.by/docs/en/sdk/ios/analytics/swift/MutableRevenueInfo.md
  - https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/swift/MutableRevenueInfo.md
  - https://appmetrica.yandex.by/docs/zh/sdk/ios/analytics/swift/MutableRevenueInfo.md
  - href: https://appmetrica.yandex.by/docs/zh/sdk/ios/analytics/swift/MutableRevenueInfo.md
    type: text/markdown
    title: Markdown version
  - href: https://appmetrica.yandex.by/docs/zh/llms.txt?revision=r21920615
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/zh/llms.txt?revision=r21920615

# MutableRevenueInfo 类

可修改的 [RevenueInfo](https://appmetrica.yandex.by/docs/zh/sdk/ios/analytics/swift/RevenueInfo.md) 类，包含关于购买的信息。

`MutableRevenueInfo` 类的实例应发送到 AppMetrica 服务器，使用 [reportRevenue](https://appmetrica.yandex.by/docs/zh/sdk/ios/analytics/swift/AppMetrica.md#method_reportRevenue) 方法的 [AppMetrica](https://appmetrica.yandex.by/docs/zh/sdk/ios/analytics/swift/AppMetrica.md) 类。

## Properties {#property_summary}

#|
|| [payload](#property_productID) | 关于购买的额外信息。 例如，可以用它来对产品进行分类。 ||
|| [productID](#property_productID) | 已购买产品的ID。 该值最多可包含 200 个字符。 ||
|| [数量](#property_quantity) | 购买的产品数量。 ||
|| [receiptData](#property_receiptData) | App Store 应用内购买订单详情。 此属性用于在应用中验证购买。 ||
|| [transactionID](#property_transactionID) | 交易 ID [transactionIdentifier](https://developer.apple.com/documentation/storekit/skpaymenttransaction/1411288-transactionidentifier) 来自 [SKPaymentTransaction](https://developer.apple.com/documentation/storekit/skpaymenttransaction) 类。 此属性用于在应用中验证购买。 ||
|#

## Property descriptions {#property_detail}

### payload {#property_payload}

`var payload: [AnyHashable : Any]`

关于购买的额外信息。 例如，它可以用于对您的产品进行分类。

您必须传递一个 `AnyHashable` 对象，该对象可以转换为有效的 JSON。 值的最大大小为30 KB。

### productID {#property_productID}

`var productID: String`

已购买产品的ID。 该值最多可包含 200 个字符。

### quantity {#property_quantity}

`var quantity: UInt`

购买的产品数量。

它用于以下公式：

```
收入 = 数量 × 价格。
```

{% note info %}

值不能为负。 如果值等于 0，购买将被忽略。

{% endnote %}

### receiptData {#property_receiptData}

`var receiptData: Data`

App Store 应用内购买订单详情。 此属性用于在应用中验证购买。 要了解更多信息，请查看[苹果文档](https://developer.apple.com/library/content/releasenotes/General/ValidateAppStoreReceipt/Chapters/ValidateRemotely.html)。

请查看获取`receiptData`的示例，位于[Sending Revenue](https://appmetrica.yandex.by/docs/zh/sdk/ios/analytics/ios-operations.md#send-revenue)部分。

{% note alert %}

必须在调用 `SKPaymentQueue.default().finishTransaction(transaction)` 之前获取该值，并与 [transactionID](#property_transactionID) 一同传输。

{% endnote %}

### transactionID {#property_transactionID}

`var transactionID: String`

交易 ID [transactionIdentifier](https://developer.apple.com/documentation/storekit/skpaymenttransaction/1411288-transactionidentifier) 来自 [SKPaymentTransaction](https://developer.apple.com/documentation/storekit/skpaymenttransaction) 类。 此属性用于在应用中验证购买。

查看获取 `transactionIdentifier` 的示例，位于 [发送收入](https://appmetrica.yandex.by/docs/zh/sdk/ios/analytics/ios-operations.md#send-revenue) 部分。

{% note alert %}

该值必须在调用 `SKPaymentQueue.default().finishTransaction(transaction)` 之前获得，并与 [receiptData](#property_receiptData) 一同传输。

{% endnote %}