Mobile tracking и AppMetrica

Приложение клиента отправляет события своей аналитики. Mobile SDK передаёт типизированный product action; embedded player отдельно отправляет события ShopStory. Эти потоки измеряют разные действия: что измеряется.

Инструкция относится к native iOS и Flutter на iOS. Примеры старого WebView bridge и Android runtime к этой поставке не относятся.

Когда отправлять событие​

1. Получите типизированный product action.
2. Проверьте payload.feedProductId и найдите товар в каталоге приложения.
3. Для перехода откройте PDP и при необходимости отправьте событие перехода.
4. Для прямой корзины выполните Cart API с текущей сессией.
5. После подтверждённого изменения отправьте add-to-cart из analytics adapter приложения.

Если оба действия открывают PDP, add-to-cart в этот момент отсутствует. Оно появится только после отдельного успешного добавления на PDP.

В native iOS delegate не имеет completion для корзины player. Flutter handler возвращает типизированный результат adapter, но он не является подтверждением изменения корзины для embedded player. Аналитика магазина должна опираться на Cart API.

Данные события​

Данные	Источник
Товарный ID	Проверенный payload.feedProductId
Источник просмотра	Необязательный payload.source: ожидаемые live, vod, mini-player
SKU и quantity	Результат cart operation приложения
Цена и валюта	Результат Cart API, а не карточка из старого снимка
Успех	Подтверждение изменения корзины
Order ID	Система заказов; для add-to-cart не нужен

source может отсутствовать или содержать неизвестное значение. В таком случае сохраните unknown в своей схеме; не восстанавливайте источник по URL и не подменяйте его предполагаемым Live. Название товара можно уточнить в каталоге приложения.

SDK payload не содержит подтверждённую цену покупки. Нулевая цена вместо неизвестной исказит денежные показатели. Согласуйте обработку неполных данных в analytics adapter.

AppMetrica​

Используйте E-commerce API версии AppMetrica, закреплённой в приложении. Для iOS ориентируйтесь на текущие классы AppMetrica и ECommerce; старые примеры с YMM* не являются инструкцией установки нового SDK.

После подтверждения Cart API создайте ECommerceProduct с товарным SKU и ECommerceCartItem с quantity и revenue. В revenue передаётся сумма по добавленной позиции с учётом количества и скидок, а не цена одной единицы. Событие ECommerce.addCartItemEvent(cartItem:) отправляется через AppMetrica.reportECommerce.

quantity и revenue описывают добавленные единицы. Если Cart API возвращает всю корзину, analytics adapter сначала выделяет результат текущего добавления.

Источник можно передать в product payload под согласованным ключом shopstory_source. Это поле схемы клиента, не автоматически добавляемое SDK событие.

Для Flutter вызов AppMetrica выполняет существующий analytics adapter приложения. Mobile SDK ShopStory не устанавливает AppMetrica и не включает analytics plugin вместо клиента.

Примеры поставщика: E-commerce, iOS Swift ECommerce API, поля ECommerceCartItem, iOS usage examples.

Consent и данные​

Применяйте принятый в приложении consent flow до передачи события в систему аналитики. Согласуйте его отдельно для аналитики приложения и embedded player. Публичный контракт ShopStory не задаёт универсальный метод отключения всех систем аналитики.

Native SDK получает параметры проекта, товарный ID, SDK/host version и сведения, нужные для media lifecycle. Embedded player имеет собственную аналитику. Полный состав данных конкретной версии и PrivacyInfo.xcprivacy проверяются по privacy-документации выданного пакета.

Не передавайте в product action или diagnostics auth tokens, cookies, платёжные данные, профиль покупателя или содержимое корзины. Analytics adapter клиента использует только поля своей согласованной схемы.

Проверка разработчиком и аналитиком​

Сценарий	Ожидаемый результат
Открытие товара из player	PDP открыта; add-to-cart не отправлен
Подтверждённое добавление	Одно событие с правильным товаром, ценой и quantity
Отказ Cart API	Нет успешного add-to-cart
Потерянный ответ	Исход проверяется до события и повторной записи
Отсутствующий source	unknown без выдуманного канала
Возврат из background	Нет повторного cart event только из-за lifecycle
Повторная доставка действия	Нет второй cart operation и события без нового подтверждения
Consent запрещён	Поведение соответствует согласованной политике приложения

Проверьте сначала локальный analytics adapter, затем доставку и отчёт AppMetrica. Отсутствие записи в ShopStory не доказывает отсутствие заказа в системе магазина.