# 🌐 API интеграция

Процесс интеграции включает несколько ключевых шагов. Убедитесь, что каждый из них выполнен:

# Версии API

В документации доступны два API-контура:

API V1 - текущие страницы этого раздела с endpoint-ами /ssapi/*. Используйте их для существующих интеграций и поддержки уже запущенных сценариев.
API V2 - новый Gateway API для server-side, web, mobile SDK и headless-сценариев. Он использует endpoints /user, /visit, /event, /choose, /strategy и /engagement.

📖 Подробнее: API V2

API reference

# 🔑 Создание API-ключа

Сгенерируйте API-ключ в вашем аккаунте, чтобы использовать его для идентификации запросов. Это первый шаг для работы с API.

📖 Подробнее: Управление API-ключами

# 📂 Передача продуктового фида

Передайте фид с информацией о продуктах и услугах, которые вы планируете использовать в товарных кампаниях.

Фид должен содержать:

Названия товаров и услуг.
Описание.
URL, изображения, цены и другие характеристики.

📖 Подробнее: Требования к продуктовому фиду

# Базовые методы

# 📜 Передача контекста страниц

Передавайте контекст страниц (например, тип страницы, данные о просматриваемом товаре), чтобы:

Использовать таргетинг на основе типа страницы.
Предоставлять персонализированные рекомендации (например, товары, похожие на текущий).

📖 Подробнее: Как настроить контекст страниц

# 🛒 Передача информации о действиях пользователей

Отслеживайте минимальный набор событий для e-commerce:

Добавление в корзину.
Покупка.

Эти события необходимы для:

Понимания поведения пользователей.
Оптимизации кампаний.
Корректного измерения эффективности.

📖 Подробнее: Руководство по событиям

# Персонализация

# 🎯 Получение кампаний персонализации

Запросите кампании персонализации через API, чтобы использовать их в виджетах или других элементах сайта или приложения.

📖 Подробнее: Получение кампаний

# 📊 Передача данных о взаимодействии пользователей

Фиксируйте ключевые действия пользователей:

Просмотры виджетов.
Клики по товарам.
Прочие действия.

Эти данные помогают анализировать поведение пользователей и оптимизировать персонализацию.

📖 Подробнее: Передача данных о взаимодействии

# Retail Media

# 🎯 Получение рекламных кампаний

Запрашивайте рекламные кампании для плейсмента через API.