<!-- Canonical: https://docs.shopstory.live/docs/resources/glossary -->

# Термины и идентификаторы

| Термин | Значение в документации |
| --- | --- |
| 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](<https://docs.shopstory.live/docs/guide/architecture>). Выбор источника товара: [commerce-интеграция](<https://docs.shopstory.live/docs/guide/custom-commerce-integrations>).
