Класс YMMRevenueInfo

Класс содержит неизменяемую информацию о доходах от покупок в приложении.

Чтобы изменить информацию о доходах, воспользуйтесь классом YMMMutableRevenueInfo.

Объект YMMRevenueInfo должен быть передан на сервер AppMetrica с помощью метода reportRevenue класса YMMYandexMetrica.

Методы экземпляра

-initWithPrice:currency:

Инициализирует экземпляр класса YMMRevenueInfo для передачи информации о покупках.

Внимание. Метод устарел. Используйте вместо него -initWithPriceDecimal:currency:.
-initWithPriceDecimal:currency:

Инициализирует экземпляр класса YMMRevenueInfo для передачи информации о покупках.

-initWithPrice:currency:quantity:productID:transactionID:receiptData:payload:

Инициализирует экземпляр класса YMMRevenueInfo для передачи информации о покупках.

Внимание. Метод устарел. Используйте вместо него ‑initWithPriceDecimal:currency:quantity:productID:transactionID:receiptData:payload:.
-initWithPriceDecimal:currency:quantity:productID:transactionID:receiptData:payload:

Инициализирует экземпляр класса YMMRevenueInfo для передачи информации о покупках.

Свойства

currency

Код валюты покупки в формате ISO 4217.

payload

Дополнительная информация о покупке.

price

Стоимость. Может быть отрицательной (например, для возврата).

Внимание. Свойство устарело. Используйте вместо него priceDecimal.
priceDecimal

Стоимость, которая задается объектом NSDecimalNumber. Может быть отрицательной (например, для возврата).

productID

Идентификатор покупки. Может содержать до 200 символов.

quantity

Количество покупок (купленных товаров).

receiptData

Подробная информация о покупке в приложении из App Store.

transactionID

Информация о покупке в приложении из App Store.

Описание методов

-initWithPrice:currency:

- (instancetype)initWithPrice:(double)price currency:(NSString *)currency
Внимание. Метод устарел. Используйте вместо него -initWithPriceDecimal:currency:.

Инициализирует экземпляр класса YMMRevenueInfo для передачи информации о покупках.

Параметры:
price

Стоимость. Может быть отрицательной (например, для возврата).

currency

Код валюты покупки в формате ISO 4217.

Значение должно содержать 3 латинских буквы в верхнем регистре.

Пример: RUB.
Примечание. Если значение не задано в формате ISO 4217 — покупка игнорируется.

Возвращает:

Объект класса YMMRevenueInfo.

-initWithPriceDecimal:currency:

- (instancetype)initWithPriceDecimal:(NSDecimalNumber *)priceDecimal currency:(NSString *)currency

Инициализирует экземпляр класса YMMRevenueInfo для передачи информации о покупках.

Параметры:
priceDecimal

Стоимость, которая задается объектом NSDecimalNumber. Может быть отрицательной (например, для возврата).

currency

Код валюты покупки в формате ISO 4217.

Значение должно содержать 3 латинских буквы в верхнем регистре.

Пример: RUB.
Примечание. Если значение не задано в формате ISO 4217 — покупка игнорируется.

Возвращает:

Объект класса YMMRevenueInfo.

-initWithPrice:currency:quantity:productID:transactionID:receiptData:payload:

- (instancetype)initWithPrice:(double)price
                     currency:(NSString *)currency
                     quantity:(NSUInteger)quantity
                    productID:(NSString *)productID
                transactionID:(NSString *)transactionID
                  receiptData:(NSData *)receiptData
                      payload:(NSDictionary *)payload
Внимание. Метод устарел. Используйте вместо него ‑initWithPriceDecimal:currency:quantity:productID:transactionID:receiptData:payload:.

Инициализирует экземпляр класса YMMRevenueInfo для передачи информации о покупках.

Параметры:
price

Стоимость. Может быть отрицательной (например, для возврата).

currency

Код валюты покупки в формате ISO 4217.

Значение должно содержать 3 латинских буквы в верхнем регистре.

Пример: RUB.
Примечание. Если значение не задано в формате ISO 4217 — покупка игнорируется.
quantity

Количество покупок (купленных товаров).

Используется в формуле расчета выручки:
Выручка = количество * стоимость
Примечание. Значение должно быть больше 0. Если значение равно 0 — покупка игнорируется.
productID

Идентификатор покупки. Может содержать до 200 символов.

transactionID

Информация о покупке в приложении из App Store.

receiptData

Подробная информация о покупке в приложении из App Store.

payload

Дополнительная информация о покупке. Например, можно использовать для категоризации ваших продуктов.

Необходимо передать объект NSDictionary, который может быть преобразован в валидный JSON. Максимальный размер значения — 30 КБ.

Возвращает:

Объект класса YMMRevenueInfo.

‑initWithPriceDecimal:currency:quantity:productID:transactionID:receiptData:payload:

- (instancetype)initWithPriceDecimal:(NSDecimalNumber *)priceDecimal
                            currency:(NSString *)currency
                            quantity:(NSUInteger)quantity
                           productID:(NSString *)productID
                       transactionID:(NSString *)transactionID
                         receiptData:(NSData *)receiptData
                             payload:(NSDictionary *)payload

Инициализирует экземпляр класса YMMRevenueInfo для передачи информации о покупках.

Параметры:
priceDecimal

Стоимость, которая задается объектом NSDecimalNumber. Может быть отрицательной (например, для возврата).

currency

Код валюты покупки в формате ISO 4217.

Значение должно содержать 3 латинских буквы в верхнем регистре.

Пример: RUB.
Примечание. Если значение не задано в формате ISO 4217 — покупка игнорируется.
quantity

Количество покупок (купленных товаров).

Используется в формуле расчета выручки:
Выручка = количество * стоимость
Примечание. Значение должно быть больше 0. Если значение равно 0 — покупка игнорируется.
productID

Идентификатор покупки. Может содержать до 200 символов.

transactionID

Информация о покупке в приложении из App Store.

receiptData

Подробная информация о покупке в приложении из App Store.

payload

Дополнительная информация о покупке. Например, можно использовать для категоризации ваших продуктов.

Необходимо передать объект NSDictionary, который может быть преобразован в валидный JSON. Максимальный размер значения — 30 КБ.

Возвращает:

Объект класса YMMRevenueInfo.

Описание свойств

currency

(nonatomic, copy, readonly) NSString *currency

Код валюты покупки в формате ISO 4217.

payload

(nonatomic, copy, readonly) NSDictionary *payload

Дополнительная информация о покупке.

price

(nonatomic, strong, nullable, readonly) double price

Внимание. Свойство устарело. Используйте вместо него priceDecimal.

Стоимость. Может быть отрицательной (например, для возврата).

priceDecimal

(nonatomic, assign, readonly) NSDecimalNumber *priceDecimal

Стоимость, которая задается объектом NSDecimalNumber. Может быть отрицательной (например, для возврата).

productID

(nonatomic, copy, readonly) NSString *productID

Идентификатор покупки. Может содержать до 200 символов.

quantity

(nonatomic, assign, readonly) NSUInteger quantity

Количество покупок (купленных товаров).

receiptData

(nonatomic, copy, readonly) NSData *receiptData

Подробная информация о покупке в приложении из App Store.

transactionID

(nonatomic, copy, reaоdonly) NSString *transactionID

Информация о покупке в приложении из App Store.