Класс YMMECommerce

Методы класса создают объект YMMECommerce.

Для различных действий пользователя есть соответствующие типы ECommerce-событий. Чтобы создать конкретный тип события, используйте нужный метод класса YMMECommerce.

Примечание. Объект YMMECommerce можно отправить с помощью метода +reportECommerce:onFailure: класса YMMYandexMetrica и протокола YMMYandexMetricaReporting.

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


+showScreenEventWithScreen:	Создает ECommerce-событие `ShowScreenEvent`. Используйте его, чтобы сообщить об открытии какой-либо страницы, например: списка товаров, поиска, главной страницы.
+showProductCardEventWithProduct:screen:	Создает ECommerce-событие `ShowProductCardEvent`. Используйте его, чтобы сообщить о просмотре карточки товара среди других в списке.
+showProductDetailsEventWithProduct:referrer:	Создает ECommerce-событие `ShowProductDetailsEvent`. Используйте его, чтобы сообщить о просмотре страницы товара.
+addCartItemEventWithItem:	Создает ECommerce-событие `AddCartItemEvent`. Используйте его, чтобы сообщить о добавлении товара в корзину.
+removeCartItemEventWithItem:	Создает ECommerce-событие `RemoveCartItemEvent`. Используйте его, чтобы сообщить об удалении товара из корзины.
+beginCheckoutEventWithOrder:	Создает ECommerce-событие `BeginCheckoutEvent`. Используйте его, чтобы сообщить о начале оформления покупки.
+purchaseEventWithOrder:	Создает ECommerce-событие `PurchaseEvent`. Используйте его, чтобы сообщить о завершении покупки.


+showScreenEventWithScreen:	Создает ECommerce-событие `ShowScreenEvent`. Используйте его, чтобы сообщить об открытии какой-либо страницы, например: списка товаров, поиска, главной страницы.
+showProductCardEventWithProduct:screen:	Создает ECommerce-событие `ShowProductCardEvent`. Используйте его, чтобы сообщить о просмотре карточки товара среди других в списке.
+showProductDetailsEventWithProduct:referrer:	Создает ECommerce-событие `ShowProductDetailsEvent`. Используйте его, чтобы сообщить о просмотре страницы товара.
+addCartItemEventWithItem:	Создает ECommerce-событие `AddCartItemEvent`. Используйте его, чтобы сообщить о добавлении товара в корзину.
+removeCartItemEventWithItem:	Создает ECommerce-событие `RemoveCartItemEvent`. Используйте его, чтобы сообщить об удалении товара из корзины.
+beginCheckoutEventWithOrder:	Создает ECommerce-событие `BeginCheckoutEvent`. Используйте его, чтобы сообщить о начале оформления покупки.
+purchaseEventWithOrder:	Создает ECommerce-событие `PurchaseEvent`. Используйте его, чтобы сообщить о завершении покупки.

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

+showScreenEventWithScreen:

+ (instancetype)showScreenEventWithScreen:(YMMECommerceScreen *)screen

Создает ECommerce-событие ShowScreenEvent. Используйте его, чтобы сообщить об открытии какой-либо страницы, например: списка товаров, поиска, главной страницы.

Параметры:


screen	Экран, который был открыт. Объект класса YMMECommerceScreen.

Возвращает:

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

+showProductCardEventWithProduct:screen:

+ (instancetype)showProductCardEventWithProduct:(YMMECommerceProduct *)product
                                         screen:(YMMECommerceScreen *)screen

Создает ECommerce-событие ShowProductCardEvent. Используйте его, чтобы сообщить о просмотре карточки товара среди других в списке.

Совет. Перед отправкой события убедитесь, что карточка товара была показана на экране более N секунд.

Параметры:


product	Товар, который был показан. Объект класса YMMECommerceProduct.
screen	Экран, на котором был показан товар. Объект класса YMMECommerceScreen.


product	Товар, который был показан. Объект класса YMMECommerceProduct.
screen	Экран, на котором был показан товар. Объект класса YMMECommerceScreen.

Возвращает:

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

+showProductDetailsEventWithProduct:referrer:

+ (instancetype)showProductDetailsEventWithProduct:(YMMECommerceProduct *)product
                                          referrer:(nullable YMMECommerceReferrer *)referrer

Создает ECommerce-событие ShowProductDetailsEvent. Используйте его, чтобы сообщить о просмотре страницы товара.

Параметры:


product	Товар, который был показан. Объект класса YMMECommerceProduct.
referrer	Информация об источнике перехода на страницу товара. Объект класса YMMECommerceReferrer.


product	Товар, который был показан. Объект класса YMMECommerceProduct.
referrer	Информация об источнике перехода на страницу товара. Объект класса YMMECommerceReferrer.

Возвращает:

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

+addCartItemEventWithItem:

+ (instancetype)addCartItemEventWithItem:(YMMECommerceCartItem *)item

Создает ECommerce-событие AddCartItemEvent. Используйте его, чтобы сообщить о добавлении товара в корзину.

Параметры:


item	Товар, который был добавлен в корзину. Объект класса YMMECommerceCartItem.

Возвращает:

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

+removeCartItemEventWithItem:

+ (instancetype)removeCartItemEventWithItem:(YMMECommerceCartItem *)item

Создает ECommerce-событие RemoveCartItemEvent. Используйте его, чтобы сообщить об удалении товара из корзины.

Параметры:


item	Товар, который был удален из корзины. Объект класса YMMECommerceCartItem.

Возвращает:

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

+beginCheckoutEventWithOrder:

+ (instancetype)beginCheckoutEventWithOrder:(YMMECommerceOrder *)order

Создает ECommerce-событие BeginCheckoutEvent. Используйте его, чтобы сообщить о начале оформления покупки.

Параметры:


order	Информация о покупке. Объект класса YMMECommerceOrder.

Возвращает:

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

+purchaseEventWithOrder:

+ (instancetype)purchaseEventWithOrder:(YMMECommerceOrder *)order

Создает ECommerce-событие PurchaseEvent. Используйте его, чтобы сообщить о завершении покупки.

Параметры:


order	Информация о покупке. Объект класса YMMECommerceOrder.

Возвращает:

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