Тема
Переменные
Именованные значения, которые можно вставить в текст через @ и использовать в Условии, Переключателе и Калькуляторе.
Откуда берутся
| Источник | Когда появляется | Примеры |
|---|---|---|
| Служебные | С начала прохождения | @score (баллы), @step, в режиме теста — @questions_count, @correct_count, @incorrect_count |
| Ссылка | С начала, из URL | UTM и get_* из параметров ссылки |
| Блоки | После ответа или скрытого шага | Вопросы, Переменная, Калькулятор |
В webhook уходят только переменные блоков (с непустым именем). Служебные и UTM в тело POST не входят.
Как вставить в текст
В полях с поддержкой упоминаний начните вводить @ и выберите имя. Можно написать @имя вручную.
Если переменная ещё не известна в этом месте сценария, в тексте у игрока останется как написали — @имя.
Типы
Строка, число, дата, диапазон дат, диапазон чисел.
У даты и диапазонов после имени можно указать ключ в квадратных скобках:
| Пример | Что получится |
|---|---|
@дата | Дата в читаемом виде |
@дата[datetime] | Дата и время |
@период[count_day] | Число календарных дней (конец периода не включается) |
@период[count_workday] / @период[count_weekend] | Будни / выходные |
@диапазон[first] / @диапазон[second] | Левый и правый конец числового диапазона |
В обычном тексте без скобок подставляется строковый вид. В формуле калькулятора нужны числа: берите ключи вроде count_day или переменную типа «Число».
Имена
Имя задаётся в настройках вопроса или в блоке «Переменная» / «Калькулятор». Оно должно быть уникальным в квизе.
Не занимайте руками префиксы utm_ и get_ — они для параметров ссылки.