Кампании позволяют внедрять ключевые элементы роста и повышения конверсии в e-commerce: от рекомендательных блоков и social proof до промо-баннеров и кастомной коммуникации. Каждый тип кампании отвечает за свою зону воздействия на пользователя: показать нужный товар, подчеркнуть ограниченность предложения, отразить УТП, вернуть внимание к корзине и т.д. Кампании можно A/B тестировать, настраивать под сегменты, запускать по условиям и замерять эффективность.

> ⚙️ Обратите внимание: **в зависимости от типа кампании могут отличаться настройки отображения и поведения**.  
> Например:  
> - У **Оверлеев** и **Уведомлений** есть настройки: триггеры появления, частота показа, позиция на экране и пр.  
> - У **Рекомендаций** таких настроек нет, но настраиваются стратегия, шаблон и отображение товаров.

---

## 🌐 ВЕБ интеграция  
Кампании запускаются на сайте через клиентский скрипт Gravity Field.  
📄 Документация: [Web Integration Script](/Integration/web_integration/script.md)

### 📌 Типы кампаний (Web)

| Тип кампании              | Описание                                                                                   | Примеры использования                                       |
|---------------------------|--------------------------------------------------------------------------------------------|-------------------------------------------------------------|
| **Динамический контент**  | Динамически добавляет или заменяет элементы на странице                                    | Таймеры, social proof, блоки УТП                            |
| **Рекомендации**          | Персонализированные подборки товаров от алгоритмов Gravity Field                                     | Виджеты: «Похожие», «С этим покупают», «Рекомендуем»        |
| **Оверлей**               | Всплывающее окно, перекрывающее экран, с настройками триггера и закрытия                  | Попап с акцией, подписка, спецпредложение                   |
| **Уведомления**           | Маленькие элементы в углу экрана, не мешают навигации                                     | Напоминание о товаре, сигнал о популярности или цене        |
| **Кастом код**            | Позволяют при помощи JS кода управлять элементами на странице практически без ограничений. Вы можете, например, перемещать элементы, менять цвета кнопок и многое другое.                                            | Кастомные правки, логика, изменения внешнего вида           |

---

## 🔌 АПИ интеграция  
Кампании, которые возвращают данные через серверный API. Вывод реализуется вручную на стороне клиента.  
📄 Документация: [API Integration](/Integration/api_integration/api_integration.md)

### 📌 Типы кампаний (API)

| Тип кампании                  | Описание                                                                            | Примеры использования                          |
|-------------------------------|-------------------------------------------------------------------------------------|------------------------------------------------|
| **Custom JSON (API)**         | Кампания возвращает JSON с содержимым вариации                                     | Кастомные блоки в приложении или на сервере    |
| **Recommendations JSON (API)**| Возвращает рекомендации в JSON, построенные по стратегии и поведению пользователя | Рекомендации в мобильных приложениях, SPA      |

---

## 📱 Кампании в приложении

Кампании в приложении настраиваются в Gravity Field и показываются в мобильном приложении через SDK или direct/headless API. Этот канал подходит для in-app сообщений, inline-блоков, подсказок, промо-механик, рекомендаций и кастомных JSON-сценариев.

📄 Документация: [Кампании в приложении](/personalization/Campaigns/app_campaigns/getting_started.md)

### 📌 Типы кампаний в приложении

| Тип кампании | Описание | Примеры использования |
|--------------|----------|-----------------------|
| **In-app сообщения** | Визуальные форматы, которые SDK может показать поверх текущего экрана | Snackbar, модальное окно, bottom sheet, overlay, tooltip |
| **Inline-блоки** | Контент, встроенный в конкретное место экрана приложения | Баннер на главной, блок рекомендаций, промо-модуль |
| **Custom JSON / Headless** | Кампания возвращает JSON, а приложение само рендерит интерфейс | BDUI, кастомная кнопка, конфигурация экрана, персональный блок |
| **Рекомендации** | Товарные подборки или product-based in-app сценарии | Рекомендации на карточке товара, в корзине или на главном экране |

---

## 🎯 Как выбрать подходящий тип кампании?

- 🧩 Встраивание на сайт → кампании из **Web-интеграции**
- 📱 Сообщения и блоки в мобильном приложении → **Кампании в приложении**
- 🔌 Серверный рендеринг, SPA, полностью кастомный вывод или тестирование backend-driven фич → **API кампании**
- 🎨 Нужно точечно управлять контентом через JS → **Кастом код**
- 🛍 Хочешь показать пользователю товары → **Рекомендации** или **Recommendations JSON**

---

## 📌 Связанные материалы

- [Как устроена кампания](./campaign_structure.md)
- [Тестирование фич через API-кампании](./feature_testing_api_campaigns.md)
- [Кампании в приложении](./app_campaigns/getting_started.md)
- [Создание рекомендательной кампании (Web)](./campaigns_create/create_rec_web_campaign.md)
- [Создание Custom Code кампаний](./campaigns_create/create_custom_code.md)
- [Описание рекомендательных алгоритмов](/personalization/Recs/algs_description.md)