Класс YMMRevenueInfo

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

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

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

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

-initWithPrice:currency:

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

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

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

Свойства

currency

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

payload

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

price

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

productID

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

quantity

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

receiptData

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

transactionID

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

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

-initWithPrice:currency:

- (instancetype)initWithPrice:(double)price currency:(NSString *)currency

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

Параметры:
price

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

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

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

Параметры:
price

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

currency

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

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

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

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

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

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

transactionID

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

Должно содержать значение transactionIdentifier из класса SKPaymentTransaction. Подробнее в документации Apple.

Значение должно быть передано вместе с receiptData для проверки транзакции.

receiptData

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

Значение должно быть передано вместе с transactionID для проверки транзакции. Пример получения:
NSURL *receiptURL = [[NSBundle mainBundle] appStoreReceiptURL];
revenueInfo.receiptData = [NSData dataWithContentsOfURL:receiptURL];
Подробнее в документации Apple.
Примечание. Получить информацию о покупке необходимо до вызова [[SKPaymentQueue defaultQueue] finishTransaction:transaction].
payload

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

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

Возвращает:

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

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

currency

(nonatomic, copy, readonly) NSString *currency

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

payload

(nonatomic, copy, readonly) NSDictionary *payload

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

price

(nonatomic, assign, readonly) double price

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

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 о покупке внутри приложения.