Перейти к основному содержимому

Аналитика и события

У ShopStory и системы аналитики магазина разные источники данных. Перед подключением определите, какой результат нужен: взаимодействия с видео, добавления в корзину или заказы. Счётчики этих действий нельзя сравнивать как одну метрику.

ДействиеЧто подтвержденоЧто оно не подтверждает
Показ mini-playerВиджет был показан по правилам проектаПросмотр полного видео или покупку
Открытие playerПользователь открыл просмотрНачало checkout
Buy intentПользователь нажал «Купить» в ShopStoryУспех Cart API
Подтверждённое добавлениеСистема магазина приняла изменение корзиныЗаказ, оплату или доставку
ЗаказСистема магазина зарегистрировала заказОплату, отсутствие отмены и возврата
Оплаченная выручкаПлатёж подтверждён системой магазинаЧистую выручку после возвратов без их отдельного учёта
Клик, подтверждение корзины и доставка событияДва источника событий. Клик не гарантирует добавление в корзину. Интерфейс и товар показаны на условном примере.
Интерфейс ShopStoryКлик «Купить»

Действие пользователя в ShopStory.

Событие UI
Buy intent

Учитывает клик, даже если магазин затем откажет.

Commerce-код магазинаCart API подтвердил добавление

Подтверждённый результат операции.

Consent и дедупликация
GA4: add_to_cart

При разрешённой отправке и без повтора операции.

PDP, rejected, unknown → без add_to_cart.

Приёмка примера confirmed cart: проверить каждый этап
  1. receiptМагазин подтвердил результат.
  2. DispatcherAdapter вызвал отправителя.
  3. Сетевой запросЗапрос ушёл в систему аналитики.
  4. ОтчётСобытие появилось в нужной системе.

Один отправитель на систему. В примере confirmed cart для GA4 reporter проверяет consent и подавляет повтор того же operationId, пока живёт его экземпляр. Заказ и оплата подтверждаются отдельно.

Переход на PDP магазина и раскрытие внутренней карточки с выбором SKU — разные действия. В зависимости от интеграции клик по фото или названию может выполнять одно из них; ни одно не является Buy intent. UTM относится к переходу по URL товара, а не к раскрытию карточки или результату покупки.

Выбрать инструкцию​

Что согласовать до разработки​

  1. Целевую систему: кабинет ShopStory, Яндекс Метрика, GA4 или AppMetrica.
  2. Источник каждого события и единственного отправителя для каждой системы.
  3. Строковый товарный ID, совпадающий с feedProductId; правила SKU и quantity.
  4. Источник цены: снимок каталога, фактический результат Cart API или заказ.
  5. Способы подключения: основной Web SDK, standalone PiP, native iOS, Flutter на iOS.
  6. Consent flow, разрешённые поля и тестовые данные.
  7. Критерий успеха: событие в браузере или приложении, запрос к системе аналитики и запись в её отчёте.

ShopStory подтверждает доступность выбранного tracking-маршрута для проекта. Подключение SDK само по себе не включает все события и системы аналитики.

Разделяйте три источника: события commerce-системы клиента, аналитику embedded player и локальные lifecycle diagnostics native SDK. Consent одного источника не управляет остальными автоматически.

hasConsent в примере подтверждённой корзины разрешает отправку события этим reporter. Он не отключает SDK/player, не отзывает уже отправленные данные и не является универсальным analytics switch. Скрытие или пауза player также не доказывают прекращение телеметрии.

До подключения зафиксируйте для выбранных версии и контура:

  1. Какие события и поля передаются, кто их отправляет и в какую систему.
  2. Когда разрешены загрузка SDK, configure и открытие player в consent flow клиента.
  3. Какие поддержанные действия применяются при отказе и отзыве consent, включая уже открытую сессию.
  4. Как проверить отсутствие запрещённых запросов до согласия и после его отзыва и получение разрешённых событий после согласия.

ShopStory передаёт состав данных native SDK и embedded player с документацией выбранной версии; для iOS учитывайте PrivacyInfo.xcprivacy. Точные способы управления SDK/player подтверждаются в integration handoff.

Приёмка проводится на согласованном test project по Network/diagnostics и целевой системе аналитики. В ней отдельно проверяются отсутствие consent, получение, отзыв во время просмотра и повторный запуск приложения или страницы. В логи не попадают cookies, tokens и данные покупателя.

Ограничения attribution​

Tracking переходов и событий не доказывает, что видео стало причиной покупки. Для оценки эффекта нужны сопоставимые группы или эксперимент.

Наблюдение E-commerce событий на PDP после mini-player подключается отдельно. Для подтверждённой связи нужны корректный товарный ID, сохранённый путь просмотра и SDK на нужной странице. Обычный cart add на PDP не следует автоматически относить к видео.

Сбор событий заказа требует отдельного согласования и SDK на странице, где магазин публикует событие заказа. Отсутствие данных с этой страницы означает отсутствие покрытия, а не нулевые продажи. Заказы, оплаты, отмены и возвраты остаются отдельными событиями системы магазина.

Приёмка аналитики​

Проверьте успешное добавление, отказ Cart API, timeout с неизвестным результатом, повторный callback и обычный переход на PDP. Для каждого сценария сохраните ожидаемое и фактическое событие без cookies, tokens и данных покупателя.

Аналитик проверяет отчёт и единицы измерения: события, товары, quantity, сумму и валюту. Разработчик проверяет момент отправки и отсутствие дублей. Наличие объекта в dataLayer ещё не подтверждает получение события системой аналитики.