Термины и идентификаторы
| Термин | Значение в документации |
|---|---|
| PDP — product detail page | Карточка товара на сайте или в приложении клиента |
| VOD — video on demand | Опубликованная запись эфира |
| Product feed | Выгрузка товарного каталога, обычно YML |
| Host app | Приложение клиента, в которое встроен SDK |
| Callback | Функция, через которую код клиента возвращает результат операции |
| Product action | Намерение открыть товар или добавить его в корзину; само по себе не результат покупки |
| Lifecycle | Создание, перенос, пауза и освобождение SDK UI и media session |
| Follow Me | Компактный player внутри приложения, продолжающий текущую media session |
| PiP / mini-player | Плавающий web-виджет на PDP; это не системный Picture-in-Picture |
| SPA | Сайт с переходами без полной перезагрузки HTML |
| Origin | Комбинация протокола, hostname и port; нужен для CORS и CSP |
| Tracking | Регистрация взаимодействий и подтверждённых действий |
| Attribution | Правило связывания события с источником; не доказательство причинного эффекта |
| Buy intent | Клик «Купить» в ShopStory; не подтверждение корзины или заказа |
| Rollout / rollback | Включение новой версии / возврат к ранее принятой версии |
| Feature flag | Управляемое включение компонента в коде клиента |
| Integration handoff | Пакет доступа и настроек проекта: версии, тестовые данные, origins, контакты и приёмка |
Идентификаторы
| Поле | Где используется | Правило |
|---|---|---|
applicationId | Public API и Mobile SDK | Строковый ID проекта, не credential |
config.clientId | Основной Web SDK | То же значение, что applicationId |
application | Query-параметр Mini-player API v2 | То же значение ID проекта; имя параметра задаёт endpoint |
feedProductId | Каталог клиента, product feed, PDP и product action | Один строковый ID без потери ведущих нулей |
products[].id | ShopStory Public API | Внутренний ID товара ShopStory; не заменяет feedProductId |
productId расширенного commerce-контракта | Обработчики товарных данных и условий | Согласованный feedProductId; отличается от внутреннего products[].id |
variantId | Расширенный commerce-контракт | ID продаваемого SKU; null для товара без вариантов |
streamId / translationId | Эфир или запись | Используйте имя из сигнатуры метода |
Не выводите тип ID из его внешнего вида. 0001001 и 1001 могут обозначать разные товары. Если Cart API принимает другой ключ, преобразование выполняет код магазина на своей границе.
Форматы запросов и ответы: Public API. Выбор источника товара: commerce-интеграция.