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

# AMAMutableRevenueInfo 类

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

必须将 `AMAMutableRevenueInfo` 类的实例发送到 AppMetrica 服务器，使用 [reportRevenue](https://appmetrica.yandex.com/docs/zh/sdk/ios/analytics/objectivec/AMAAppMetrica.md#method_reportRevenue) 方法的 [AMAAppMetrica](https://appmetrica.yandex.com/docs/zh/sdk/ios/analytics/objectivec/AMAAppMetrica.md) 类。

## Properties {#property_summary}

#|
|| [payload](#property_payload) | 关于购买的额外信息。 例如，可以用它来对产品进行分类。 ||
|| [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}

`(nonatomic, copy) NSDictionary *负载`

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

它应该包含可以转换为有效 JSON 的 `NSDictionary` 对象。 值的最大大小为 30 KB。

### productID {#property_productID}

`(nonatomic, copy) NSString *产品ID`

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

### quantity {#property_quantity}

`(nonatomic, assign) NSUInteger 数量`

购买的产品数量。

它用于以下公式：

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

{% note info %}

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

{% endnote %}

### receiptData {#property_receiptData}

`(非原子，拷贝) NSData *receiptData`

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

有关获取 `receiptData` 的示例，请参阅 [发送收入](https://appmetrica.yandex.com/docs/zh/sdk/ios/analytics/ios-operations.md#send-revenue) 部分。

{% note alert %}

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

{% endnote %}

### transactionID {#property_transactionID}

`(nonatomic, copy) NSString *事务ID`

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

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

{% note alert %}

此值应与[receiptData](#property_receiptData)一起传递。

{% endnote %}