Как API используется в персонализации
Пользователь открывает PDP
↓
Ваш сервер → API-запрос к Gravity Field: GET /recommendations?user_id=123&item_id=456
↓
Gravity Field → возвращает JSON с 6 рекомендованными товарами
↓
Ваш сервер → рендерит HTML с рекомендациями → отдаёт браузеру пользователя
Server-side vs Client-side интеграция
| Параметр | JS-тег (Client-side) | REST API (Server-side) |
|---|---|---|
| Скорость внедрения | Быстро (1 день) | Требует разработки (1–2 недели) |
| Устойчивость к блокировщикам | Уязвима | Устойчива |
| Контроль над данными | Ограниченный | Полный |
| SEO (рекомендации в HTML) | Нет | Да |
| Подходит для | Быстрого старта | Production high-load |
Основные эндпоинты API персонализации
// Получить рекомендации
GET /v1/recommendations?user_id=USER&context=pdp&item_id=ITEM&limit=6
// Отправить событие
POST /v1/events
{"event": "purchase", "user_id": "USER", "item_id": "ITEM", "price": 4500}
// Получить сегменты пользователя
GET /v1/segments?user_id=USER
Кеширование рекомендаций
При высоком трафике (>500K MUV) рекомендации часто кешируют на стороне вашего сервера на 5–15 минут. Это снижает нагрузку на API и задержку ответа — за счёт небольшого снижения актуальности персонализации.