Переменные

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

Чтобы открыть панель переменных, нажмите значок { } на левой панели. Панель содержит три вкладки:

Пользовательские: Переменные, которые вы создаёте и настраиваете самостоятельно.
Продуктовые: Встроенные переменные, подтягивающие локализованные данные о продукте и офере из стора.
Элементные: Переменные, привязанные к состояниям элементов на холсте.

Пользовательские переменные

Создание кастомной переменной

На панели переменных нажмите +.
Введите имя переменной.
Выберите тип: String, Number или Boolean.
Задайте начальное значение — это значение, которое переменная принимает при запуске флоу.
Нажмите Create variable.

Используйте точки в именах, чтобы группировать связанные переменные — например, user.score или user.goal.

Обновление переменной через взаимодействие

Подробнее — в статье Действия.

Вы можете обновить значение переменной в рантайме, добавив действие Set up variables к любому элементу.

Выберите элемент на канвасе.
На вкладке Interactions нажмите Add trigger.
Выберите On tap и нажмите Add action. В выпадающем списке Action type выберите Set up variables.
Нажмите Add variable. Выберите переменную и задайте новое значение.

Например, можно присвоить разные значения переменной user.goal в зависимости от ответа пользователя в квизе, а затем использовать эту переменную для перехода на нужный экран.

Обновление переменной через взаимодействие

Переменные продукта

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

Переменная	Описание	Пример
`<PROD_TITLE/>`	Локализованное название продукта	Premium Subscription
`<PROD_PRICE/>`	Локализованная цена за один расчётный период	$9.99
`<PROD_PRICE_PER_DAY/>`	Цена подписки, делённая на количество дней в расчётном периоде. Пусто для разовых покупок.	$0.33
`<PROD_PRICE_PER_WEEK/>`	Цена подписки, делённая на количество недель в расчётном периоде. Пусто для разовых покупок.	$2.33
`<PROD_PRICE_PER_MONTH/>`	Цена подписки, приведённая к одному месяцу. Пусто для разовых покупок.	$9.99
`<PROD_PRICE_PER_YEAR/>`	Цена подписки, приведённая к одному году. Пусто для разовых покупок.	$119.88
`<OFFER_PRICE/>`	Локализованная цена introductory offer или promotional offer. Пусто, если пользователь не имеет права на офер.	$0.99
`<OFFER_BILLING_PERIOD/>`	Локализованный расчётный период офера. Совпадает с `<OFFER_FULL_DURATION/>` для пробных и предоплатных оферов. Пусто, если пользователь не имеет права на офер.	1 week
`<OFFER_FULL_DURATION/>`	Локализованная полная длительность офера. Пусто, если пользователь не имеет права на офер.	1 month
Значения переменных оффера зависят от типа оффера, на который имеет право пользователь. Для примера возьмём недельную подписку «Premium Subscription» за $5 с тремя возможными офферами:

Pay As You Go: первые 3 недели по $3 (списывается еженедельно), затем $5/неделю.
Pay Up Front: первые 3 недели за $8 (списывается сразу), затем $5/неделю.
Free Trial: первая неделя бесплатно, затем $5/неделю.

В этом примере <PROD_TITLE/> возвращает «Premium Subscription», а <PROD_PRICE/> — $5. Значения переменных оффера зависят от того, на какой оффер имеет право пользователь:

Переменная	Pay As You Go	Pay Upfront	Free Trial
`<OFFER_PRICE/>`	$3	$8	$0
`<OFFER_BILLING_PERIOD/>`	1 week	3 weeks	1 week
`<OFFER_FULL_DURATION/>`	3 weeks	3 weeks	1 week

Для офферов Pay Upfront и Free Trial <OFFER_BILLING_PERIOD/> и <OFFER_FULL_DURATION/> возвращают одинаковое значение. Для Pay As You Go они различаются, так как расчётный период составляет одну неделю, а полная длительность — три недели.

Подробнее об офферах и их настройке см. в разделе Офферы.

Переменные элементов

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

Тип переменной зависит от группы:

Одиночный выбор: Квизы с одиночным выбором и вкладки:
- selected_id: ID элемента для использования в условиях
- selected_title: заголовок элемента для использования в динамическом тексте
Множественный выбор: Квизы с множественным выбором:
- selected_ids: ID элементов для использования в условиях
- selected_titles: заголовки элементов для использования в динамическом тексте
Переключатель: Переключатель триала:
- is_selected: булево значение Распространённые сценарии использования:
Отображение разного контента в зависимости от того, включён ли переключатель пробного периода.
Переход пользователей на разные экраны в зависимости от их ответов в квизе

Использование переменных в тексте

Чтобы вставить переменную в текстовый элемент:

Выберите текстовый элемент на холсте.
На вкладке Design найдите поле Content и введите текст.
Нажмите на иконку { } в поле.
Выберите переменную из списка.

Переменные можно также использовать в других элементах:

Используйте переменные в ссылках и алертах, чтобы сделать их динамическими
Создавайте динамические условия на основе переменных. Например, условие может выглядеть так: if experience.current > experience.target, navigate to...