Переменные

Именованные значения, которые можно вставить в текст через @ и использовать в Условии, Переключателе и Калькуляторе.

Откуда берутся

Источник	Когда появляется	Примеры
Служебные	С начала прохождения	@score (баллы), @step, в режиме теста — @questions_count, @correct_count, @incorrect_count
Ссылка	С начала, из URL	UTM и get_* из параметров ссылки
Блоки	После ответа или скрытого шага	Вопросы, Переменная, Калькулятор, Таймер

В webhook в answers уходят переменные блоков (с непустым именем). Служебные @score туда не входят. UTM — отдельным объектом utm в том же POST.

Как вставить в текст

В полях с поддержкой переменных начните вводить @ и выберите переменную. Можно написать @name вручную.

Если переменная ещё не известна в этом месте сценария, в тексте у пользователя останется как написали — @name.

Имена

Имя задаётся в настройках вопроса или в блоке «Переменная» / «Калькулятор» / «Таймер». Только латинские буквы, цифры и _. Оно должно быть уникальным в проекте.

Не занимайте служебные имена и префиксы utm_ и get_ — они для параметров ссылки.

Таблица зарезервированных имен:

Имя	Тип	Что значит
@score	число	Баллы, суммируются из значений ответов
@step	число	Шаг (номер вопроса/экрана)
@questions_count	число	Пройдено вопросов (режим тестирования)
@correct_count	число	Правильных ответов (режим тестирования)
@incorrect_count	число	Неправильных ответов (режим тестирования)
@utm_source	задаётся в настройках меток	Источник кампании из ссылки
@utm_medium	задаётся в настройках меток	Тип трафика из ссылки
@utm_campaign	задаётся в настройках меток	Название кампании из ссылки
@utm_content	задаётся в настройках меток	Идентификатор объявления из ссылки
@utm_term	задаётся в настройках меток	Ключевое слово из ссылки
@utm_*	задаётся в настройках меток	Любая другая UTM-метка с этим префиксом
@get_*	задаётся в настройках параметров	Свой GET-параметр из ссылки, например @get_ref

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

Типы бывают примитивные и ссылочные. Примитивное значение сразу идёт в текст, условие или калькулятор. Ссылочное — дата или пара «от — до»: целиком его в формулу не подставить, сначала нужно привести к строке или числу.

Вид	Типы в редакторе	Что внутри
Примитивные	Строка, Число	Одно значение
Ссылочные	Дата, Диапазон дат, Время, Диапазон времени, Диапазон чисел	Дата, время суток или два конца периода

Преобразование — ключ в квадратных скобках: @period[count_day]. Без ключа в тексте подставляется читаемая строка. В калькуляторе и сравнениях «больше / меньше» нужны числа — без ключа ссылочная переменная там не сработает.

Дата

Как указать	Во что превращается	Зачем
@date или @date[string]	строка	Показать дату в тексте: 01.01.2026
@date[datetime]	строка	Показать дату со временем: 01.01.2026 12:00

Диапазон дат

Как указать	Во что превращается	Зачем
@period или @period[string]	строка	Показать период в тексте
@period[datetime]	строка	Показать период со временем
@period[count_day]	число	Длительность в днях для калькулятора и условий
@period[count_workday]	число	Только будни (пн–пт)
@period[count_weekend]	число	Только выходные (сб и вс)

Счётчики дней: начало периода входит, конец — нет.

Время

Как указать	Во что превращается	Зачем
@time или @time[hhmm]	строка	Показать часы и минуты: 12:30
@time[hhmmss]	строка	Показать часы, минуты и секунды: 12:30:00
@time[hours]	число	Часы, от 0 до 23
@time[minutes]	число	Минуты, от 0 до 59
@time[seconds]	число	Секунды, от 0 до 59. Если секунды не вводили — 0

У таймера-инструмента тот же тип время, но в переменной хранится остаток отсчёта. В тексте — @имя и @имя[hhmmss]. В условии сравнивайте переменную без модификатора.

Диапазон времени

Как указать	Во что превращается	Зачем
@window или @window[string]	строка	Показать период: 12:00 - 13:30
@window[count_minute]	число	Сколько целых минут между концами
@window[count_second]	число	Сколько секунд между концами

Диапазон чисел

Как указать	Во что превращается	Зачем
@range или @range[string]	строка	Показать пару «от — до» в тексте
@range[first]	число	Левый конец («от») в формуле или условии
@range[second]	число	Правый конец («до») в формуле или условии