Структура JSON

JSON поддерживает шесть типов данных: строки, числа, булевы значения, null, объекты (пары ключ–значение) и массивы. Этого достаточно для любых структур данных в e-commerce.

{
  "item_id": "SKU-42819",
  "name": "Кроссовки беговые",
  "price": 7990.00,
  "in_stock": true,
  "categories": ["Обувь", "Спорт", "Беговые"],
  "attributes": {
    "brand": "RunFast",
    "color": "синий",
    "sizes_available": [40, 41, 42, 43]
  }
}

Этот фрагмент — типичная карточка товара. Вложенные объекты и массивы позволяют передавать иерархические данные без дополнительных конвенций.

JSON в контексте платформ персонализации

Платформы персонализации используют JSON в трёх основных сценариях:

API-ответы рекомендаций. Запрос: GET /recommendations?user_id=123&widget=pdp. Ответ — JSON-массив с товарами, каждый с полями id, title, price, image_url, score. Фронтенд рендерит виджет на основе этого массива.

Передача событий. Каждое действие пользователя (просмотр, клик, покупка) отправляется как JSON-объект в Event API. Поля: тип события, идентификатор товара, timestamp, идентификатор пользователя/сессии.

Product feed. Каталог товаров поставляется в форматах JSON или JSONL для первичной и инкрементальной загрузки в модели рекомендаций.

Важно: согласуйте схему JSON-событий с платформой на этапе интеграции и зафиксируйте её в виде JSON Schema. Изменения в именах полей (например, product_id → item_id) без обновления схемы ломают трекинг молча — без явных ошибок в логах.