# 🧩 Работа с переменными в Gravity Field

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

Это особенно полезно, если вы хотите:

  • Изменять текст, изображения, цвета или ссылки в шаблоне без правки кода;
  • Быстро настраивать разные версии кампаний;
  • Передавать данные в шаблон из API (например, SKU или показатели по товару);
  • Позволить бизнес-пользователям управлять контентом самостоятельно.

💡 Использование переменных ускоряет запуск кампаний и позволяет повторно использовать шаблоны. Подробнее см. Работа с шаблонами


# Что можно сделать с переменными?

  • Превратить любой фрагмент HTML / CSS / JS в переменную;
  • Связывать переменные с полями в интерфейсе;
  • Использовать переменные как в Web, так и в API-кампаниях;
  • Группировать переменные для удобной навигации.

# 🛠 Как создать переменную?

  1. Откройте визуальный редактор шаблона.
  2. Выделите нужный элемент на странице.
  3. Кликните правой кнопкой мыши и выберите "Add Variable".

  1. В правой панели задайте:
    • Название переменной.
    • Тип переменной (например, текст, изображение, число).
    • Дополнительные параметры — зависят от типа.


# 📋 Типы переменных

В таблице ниже — все доступные типы переменных и где они применяются:

Тип переменной Параметры Кампании
Текст Значение по умолчанию Web / API
Изображение Загрузка файла (до 6 МБ) Web / API
Выпадающий список Пары ключ — значение Web / API
Палитра цветов HEX / RGB + прозрачность Web / API
Число Значение по умолчанию, диапазон (мин/макс) Web / API
Рекомендательная стратегия Выбор из доступных стратегий Web
CSS селектор Ввод произвольного селектора Web
Social Proof (Product Performance) Динамические данные по просмотрам/покупкам за период Web

# 🔍 Как выглядит переменная в интерфейсе?

  • При наведении курсора — показывается подсказка.
  • Справа от поля — иконки для редактирования и удаления.
  • Значение переменной можно изменить прямо в интерфейсе без захода в код.

# 📌 Примеры по типам:

# 📝 Текст

Подходит для заголовков, CTA, описаний, промокодов.


# 🖼 Изображение

Загрузка баннера, фона или иконки.

Допустимые форматы:
tiff, jpg, png, webp, gif, svg, mp4 и другие.


# 📎 Выпадающий список

Позволяет выбрать одно из предопределённых значений (например, “маленький / средний / большой”).


# 🎨 Палитра цветов

Удобно для настройки фонов, рамок, текста — без необходимости править CSS.


# 🔢 Число

Полезно, если нужно задать, например, отступ, таймер, процент скидки и т.п.


# 🤖 Рекомендательная стратегия

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


# 🎯 Social Proof (Product Performance)

Переменная автоматически подставляет данные о популярности товара.

Примеры:

  • "42 человека просмотрели этот товар за неделю"
  • "18 покупок за 2 дня"

Доступные периоды: день, два дня, неделя, месяц.

⚠️ Работает только на страницах товаров.


# 🧱 Группировка переменных

Если в шаблоне много переменных — вы можете сгруппировать их для удобства.

  • Нажмите + Variables Group
  • Укажите:
    • Название группы
    • Цвет
    • Переменные, которые в неё войдут

Настройки группы можно изменить, кликнув по иконке управления:


# Быстрый чеклист

  • Добавили переменные в нужные элементы шаблона
  • Задали каждому переменной имя и тип
  • Проверили, что все переменные отображаются в панели
  • Протестировали замену значений в интерфейсе
  • Использовали группы для удобства, если переменных много

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