Аналитика и события
У ShopStory и системы аналитики магазина разные источники данных. Перед подключением определите, какой результат нужен: взаимодействия с видео, добавления в корзину или заказы. Счётчики этих действий нельзя сравнивать как одну метрику.
| Действие | Что подтверждено | Что оно не подтверждает |
|---|---|---|
| Показ mini-player | Виджет был показан по правилам проекта | Просмотр полного видео или покупку |
| Открытие player | Пользователь открыл просмотр | Начало checkout |
| Buy intent | Пользователь нажал «Купить» в ShopStory | Успех Cart API |
| Подтверждённое добавление | Система магазина приняла изменение корзины | Заказ, оплату или доставку |
| Заказ | Система магазина зарегистрировала заказ | Оплату, отсутствие отмены и возврата |
| Оплаченная выручка | Платёж подтверждён системой магазина | Чистую выручку после возвратов без их отдельного учёта |
В статистике ShopStory клик «Купить» учитывается как Buy intent, даже если Cart API затем вернул ошибку. В E-commerce аналитике магазина добавление отправляется после подтверждения корзины. Разница между этими числами ожидаема.
Клик по фото или названию товара открывает PDP и не является Buy intent. UTM описывает источник перехода, а не результат покупки.
Выбрать инструкцию
- Web: Яндекс Метрика, GA4 и UTM — подключение, формат событий и проверка на сайте.
- Mobile: события приложения и AppMetrica — tracking после product action без собственного WebView bridge.
- Добавление в корзину — когда разрешено подтвердить действие.
- Безопасность — данные, которые не должны попадать в события и логи.
Что согласовать до разработки
- Целевую систему: кабинет ShopStory, Яндекс Метрика, GA4 или AppMetrica.
- Источник каждого события и единственного отправителя для каждой системы.
- Строковый товарный ID, совпадающий с
feedProductId; правила SKU и quantity. - Источник цены: снимок каталога, фактический результат Cart API или заказ.
- Способы подключения: основной Web SDK, standalone PiP, native iOS, Flutter на iOS.
- Consent flow, разрешённые поля и тестовые данные.
- Критерий успеха: событие в браузере или приложении, запрос к системе аналитики и запись в её отчёте.
ShopStory подтверждает доступность выбранного tracking-маршрута для проекта. Подключение SDK само по себе не включает все события и системы аналитики.
Ограничения attribution
Tracking переходов и событий не доказывает, что видео стало причиной покупки. Для оценки эффекта нужны сопоставимые группы или эксперимент.
Наблюдение E-commerce событий на PDP после mini-player подключается отдельно. Для подтверждённой связи нужны корректный товарный ID, сохранённый путь просмотра и SDK на нужной странице. Обычный cart add на PDP не следует автоматически относить к видео.
Сбор событий заказа требует отдельного согласования и SDK на странице, где магазин публикует событие заказа. Отсутствие данных с этой страницы означает отсутствие покрытия, а не нулевые продажи. Заказы, оплаты, отмены и возвраты остаются отдельными событиями системы магазина.
Приёмка аналитики
Проверьте успешное добавление, отказ Cart API, timeout с неизвестным результатом, повторный callback и обычный переход на PDP. Для каждого сценария сохраните ожидаемое и фактическое событие без cookies, tokens и данных покупателя.
Аналитик проверяет отчёт и единицы измерения: события, товары, quantity, сумму и валюту. Разработчик проверяет момент отправки и отсутствие дублей. Наличие объекта в dataLayer ещё не подтверждает получение события системой аналитики.