Как подключить ShopStory
Встройте видео на сайт или в приложение, свяжите товары и настройте аналитику. Выберите инструкцию для своей платформы.
Для первого запуска команда ShopStory выдаёт applicationId, тестовый контент и доступ к SDK. Web origin регистрируется до подключения.
curl --fail-with-body --get \
https://app.shopstory.live/v3/streams \
--data-urlencode \
"applicationId=assigned-application-id"body.availableStreams[]Три варианта интеграции
Web SDK
Готовый каталог, player и mini-player на сайте. ShopStory поддерживает интерфейс и обновления плеера; клиент подключает SDK и свою commerce-систему.
- Для запуска нужен зарегистрированный web origin
- В инструкции есть готовая HTML-страница и starter
Public API
Данные эфиров и записей для собственного интерфейса. API работает только на чтение; клиент реализует загрузку, пустые состояния и обработку ошибок.
- Для запросов нужен выданный ShopStory applicationId
- Quickstart содержит запросы и локальные fixtures
Mobile SDK
Native iOS и Flutter на iOS: product video на PDP, полный player и Follow Me. Навигация, авторизация и корзина остаются в приложении клиента.
- Отдельные инструкции и starters для iOS и Flutter
- Зафиксированные версии пакетов и checklist приёмки
Как проходит подключение
Получить конфигурацию
Согласуйте источник товаров, товарный ID, платформы и тестовую среду.
Запустить пример
Подключите SDK или API и проверьте выданный тестовый товар и VOD.
Подключить commerce и tracking
Обработайте product actions. Отправляйте результат корзины после ответа вашей системы.
Проверить выпуск
Пройдите сценарии без контента, с ошибкой сети и возвратом из player. Подготовьте rollback.
Web SDK, Public API и Mobile SDK
| Критерий | Web SDK | Public API | Mobile SDK |
|---|---|---|---|
| Интерфейс | Готовые компоненты ShopStory | Проектирует и поддерживает клиент | SDK-компоненты внутри native host app |
| Настройка ShopStory | Домены, тема, источник товаров и mini-player | applicationId и согласованные origins | applicationId, package access и runtime policy |
| Обработка ошибок | Ошибки плеера и виджетов обрабатывает SDK | Реализуется клиентом по API-контракту | SDK скрывает свои компоненты при сбое; host app продолжает работать |
| Commerce-действия | Переход к товару или согласованный callback | Реализует клиент | Native product route или cart handler клиента |
| Поставка | Production script URL | Публичный read-only HTTP contract | Native SDK или совместимая Flutter/native пара |
Материалы для внедрения
Разработчику
Аналитику и QA
Что публикуется и куда писать
Куда обращаться
- Команда внедрения ShopStory
- support@shopstory.live
- Центр помощи по работе с продуктом
- Для диагностики передайте платформу, версии, время и шаги воспроизведения без access tokens и данных покупателей.
Доступные материалы
- Контракты Web SDK, Mobile SDK и Public API, требования к фиду и примеры запросов без учётных данных.
- Совместимость версий и порядок обновления описаны в версиях Mobile SDK. Доступ к пакетам и параметры проекта передаются отдельно.
- Работа в кабинете и проведение эфира описаны в центре помощи.