# 🧱 Шаблоны в Gravity Field

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

---

## 🚀 Зачем использовать шаблоны?

| Преимущество                         | Что это даёт?                                                                 |
|-------------------------------------|--------------------------------------------------------------------------------|
| 💨 Быстрое создание кампаний        | Не нужно каждый раз писать код — используйте готовую структуру                 |
| 🔧 Редактирование без разработчиков | Бизнес-пользователь может менять контент прямо в интерфейсе через переменные   |
| ⚙️ Лёгкий вес фронтовой интеграции  | В код страницы подгружаются только переменные, а не весь HTML шаблона         |

---

## ✏️ Как создать шаблон

Есть два способа:

### 1️⃣ Через раздел Templates

- Перейдите в меню **Assets → Templates**
- Нажмите **Создать шаблон**
- Укажите:
  - Название
  - Тип кампании (Web/API, Dynamic, Overlay и т.д.)
  - Превью изображение

![](/images/manage_templates/Screenshot_2024-09-12_at_17.14.14.png)

---

### 2️⃣ Из редактирования вариации

- Откройте существующую кампанию
- Перейдите в редактирование вариации
- Нажмите **Save as Template** в правом верхнем углу

> 📌 Шаблон будет сохранён вместе со всей текущей структурой (HTML, CSS, JS и переменные)

---

## 🛠 Управление шаблонами

- Изменения шаблона влияют на **все кампании**, созданные на его основе.
- После правок шаблона нужно **обновить версии экспириенсов**, чтобы они применились.
- Вариации, привязанные к шаблонам, **нельзя редактировать напрямую** — только через шаблон.

> 🔁 Рекомендуется не отвязывать вариацию от шаблона. Лучше использовать **дополнительные переменные** для кастомизации.

![](/images/manage_templates/2024-09-12_19-50-41.png)

---

## 🎨 Выбор шаблона при создании кампании

При создании новой кампании (Web или API), вы сможете выбрать один из:

- **Штатных шаблонов Gravity Field**
- **Шаблонов, разработанных под ваш проект**

![](/images/manage_templates/Screenshot_2024-09-12_at_15.07.02.png)

После выбора шаблона вы продолжаете создание кампании в стандартной последовательности:

- [Создание Web-кампании](./create_web_campaigns.md)
- [Создание API-кампании](./api_campaigns.md)

---

## 🧩 Интерфейс редактирования шаблона

![](/images/manage_templates/Screenshot_2024-09-12_at_17.14.32.png)

| Элемент | Назначение |
|--------|------------|
| 💾 Save as Template | Сохранение текущей структуры как нового шаблона |
| 👁 Preview          | Предпросмотр на сайте (только для Web) |
| 🧬 View modes       | Переключение между HTML / CSS / JS / Variables |
| 🧳 Groups           | Группировка переменных |
| 🎛 Переменные       | Управление содержимым кампании (цвета, тексты, изображения и т.д.) |
| 🖼 Live preview     | Обновление визуализации в реальном времени (для виджетов типа Dynamic / Recommendations / Overlay / Notification) |
| ✅ Save             | Сохранение шаблона / вариации |

---

## 🧠 Переменные в шаблонах

Переменные позволяют редактировать содержимое шаблона без доступа к коду.  
Вы можете назначить переменными любые элементы:

- Текст (заголовки, CTA)
- Изображения / видео
- Цвета и стили
- Стратегии рекомендаций
- Динамические данные (social proof)

📘 Подробнее: [Работа с переменными](./variables.md)

---

## ✅ Чеклист при работе с шаблонами

- [x] Создан шаблон под нужный тип кампании
- [x] Структура шаблона включает переменные
- [x] Указано превью и корректно задана логика
- [x] Шаблон используется в кампаниях через выбор в интерфейсе
- [x] Обновление шаблона влияет на все кампании на его основе

---

## 📚 Полезные материалы

- [Работа с переменными](./variables.md)
- [Создание Web-кампаний](./create_web_campaigns.md)
- [API-кампании](./api_campaigns.md)
