Локальные и глобальные переменные в воронках

Переменная — это атрибут, вместо которого подставляются индивидуальные данные пользователя или связанного с ним объекта. Эти данные воронка «запоминает» с помощью переменных, и их можно в дальнейшем использовать в любом месте воронки:

• для вывода пользователю персонализированной информации, например, чтобы показывать ему количество заработанных очков/баллов/монет или обратиться по имени в сообщении;
• для проверки перед запуском действий, например, чтобы добавлять пользователя в группу, только если он посетил страницу с оффером.

Для создания переменных используются выражения, работу с которыми рассмотрели в статье «Работа с выражениями в модуле „Воронки“». В этой статье рассмотрим два типа переменных — локальные и глобальные, — а также как их правильно использовать в воронках.

Локальная переменная — это переменная, которая будет действовать только в рамках отдельно взятой воронки.

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

• сессия (session),
• пользователь (user),
• заказ (deal),
• чат (chat).

Чтобы создать локальную переменную:

1. Перейдите на вкладку «Запуск», зайдите в настройки реактивности интересующей ноды.
2. Отметьте чекбокс «Установить переменные» и пропишите нужное выражение в поле «Код преобразования». Например:
   user.visitedPage = true — в нашем примере будет означать, что пользователь посетил страницу с оффером.
   
   Подробнее о том, как правильно прописать переменную и присвоить ей значение, читайте [в разделе ниже ▼].

Когда агент «пользователь» завершит этот шаг воронки, для него будет присвоено значение указанной переменной. Эту переменную можно будет использовать в других местах воронки. Например, можно будет проверить, посещал ли пользователь страницу, прежде чем отправлять ему письмо со скидкой. Подробнее о проверке переменных [в разделе ниже ▼].

Для чата или пользователя переменную можно присвоить также через настройку в нодах «Команда бота» и «Ввод пользователя». В указанную переменную будет записан текст сообщения, отправленного пользователем.

Чтобы правильно прописать переменную и присвоить ей значение, нужно использовать конструкцию агент.переменная = значение:

1. Выбрать агента, для которого вы хотите записать информацию, и прописать его название: session, user, deal или chat. Например, user — если вы хотите записать данные для пользователя.
2. Через точку указать название переменной — оно может быть любым, но должно начинаться с буквы и быть написано латиницей. Например, .visitedWebinar — для записи того, что пользователь посетил вебинар.
3. Написать знак «равно» и указать присваиваемое значение. Например, = «yes» — если нужно записать положительное значение.

Получится выражение user.visitedWebinar = «yes» — оно будет означать, что пользователь, которому присвоена эта переменная, посетил вебинар. По сути это выражение составлено на языке javascript. Подробнее о составлении javascript-выражений читайте в статье «Работа с выражениями в модуле воронок».

Например, в ноде «Страница» может быть только два агента, которым можно присвоить переменную:

• сессия,
• авторизованный пользователь.

А вот агенту «заказ» в этой же ноде присвоить переменную нельзя, т. к. заказ не может посетить страницу.

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

1. Текст — обязательно должен быть обернут в кавычки.
   Пример правильного присвоения: user.status = "new".
   Пример присвоения с ошибкой: user.status = new.
2. Число — может быть положительным или отрицательным. Поддерживает арифметические операции с другими переменными. Например, можно на старте задать значение user.coins = 0, после этого на определенном шаге воронки прибавить к значению число.
   Пример: user.coins = user.coins + 1 — если использовать одну переменную,
   user.total = user.coins + 1 — если использовать разные переменные.
3. Логическое значение (истина/ложь) — присваивается как true (истина) или false (ложь). Бывает удобно для проверки условия ДА/НЕТ. Записывается без кавычек.
   Пример: user.sawOffer = true.

Для проверки переменной перед запуском действия:

1. Перейдите в настройки перехода (стрелки).
2. Выберите «Установить условие».

3. В зависимости от задачи выберите опцию «Запустить, если» — например, «все условия выполнены», если нужно, чтобы действие запускалось только при наличии переменной с нужным значением.
4. Установите вариант «Значения переменных».

5. В поле ниже пропишите выражение, с помощью которого будут проверяться необходимые переменные с нужными значениями. Для этого вы можете использовать различные операторы.

Существует множество операторов для работы с переменными. Более подробно изучить логические операторы вы можете в открытых источниках, например, в справочниках по Javascript. Рассмотрим наиболее используемые.

Если переменной присваивается значение true/false, то в выражении можно просто записать эту переменную, без операторов. Например, при посещении вебинара пользователю присвоено значение user.visitedStream = true. Тогда на переходе для проверки «был ли пользователь на эфире» можно прописать только саму переменную user.visitedStream.

В этом случае проверка сработает следующим образом:

• Если переменная не была установлена для агента, то он не пройдет проверку и действие не будет запущено (false).
• Если переменная равна пустому тексту (""), нулю (0) или отрицательному числу (-4), то агент не пройдет проверку и действие не будет запущено (false).
• Если переменная равна любому непустому тексту или положительному числу, то агент пройдет проверку и действие будет запущено (true).

Глобальная переменная — это переменная, которая будет доступна в любой воронке аккаунта.

Для работы с глобальными переменными используйте одноименную ноду.

С помощью этой ноды вы можете:

• создать глобальную переменную;
• задать переменную, т. е. присвоить ее объекту;
• извлечь переменную, чтобы использовать ее в текущей воронке.

Чтобы создать глобальную переменную:

1. Добавьте ноду «Глобальная переменная» и перейдите в ее настройки.
2. Нажмите «Новая переменная».

3. Пропишите ключ переменной — то, как она будет записана в системе и как вы будете прописывать ее в дальнейшем для присвоения и проверки. Ключ переменной:
   • может содержать только латиницу и цифры;
   • не может начинаться с цифры и содержать пробелы (вместо них можно использовать нижнее подчеркивание _).
   Пример: scores.
4. Пропишите название переменной — используется для внутреннего учета и поиска.
   Пример: Количество очков.
5. Нажмите «Создать переменную».

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

1. Задать переменную для нужного объекта.
2. Извлечь ее в одной или нескольких воронках для использования.

С помощью действия «Задать переменную» вы можете присвоить переменную для объекта, прошедшего ноду. Другими словами, вы сообщаете системе, для какого объекта и каким образом будет вычисляться переменная.

Чтобы задать переменную, заполните 3 поля:

1. Тип агента: «Пользователь», «Заказ», «Сессия», «Чат» или «Общая». Вариант «Общая» используйте, чтобы создать единую переменную, которую можно будет присваивать для агентов любого типа. Например, таким образом можно сохранять номер телефона организации, ссылку на актуальное мероприятие или даты запуска, которые достаточно поменять в одном месте для применения во всех воронках.

2. Переменная — здесь отображаются все доступные в аккаунте глобальные переменные. Вы можете выбрать существующую или создать новую.
3. Выражение для вычисления значения переменной.
   В этом выражении вы можете использовать значение current — текущее значение переменной. Если записать выражение в таком виде (current ?? 0) + 1, то оно сначала получает текущее значение переменной (current). Затем к полученному числу добавляется 1 (+ 1). Если значение не было задано, то используется значение 0 (?? 0) и к нему далее так же прибавляется +1.

Таким образом, например, вы можете создать воронку с рейтинговой системой, в которой за определенные события пользователю будут начисляться очки/баллы/монеты и записываться в глобальную переменную. Далее эту переменную можно будет использовать в других воронках для проверки количества начисленных очков, подробнее в разделе [Как извлечь переменную для использования в воронке ▼].

При успешном присвоении переменной вы увидите сообщение об этом в отладке, а также все переменные текущего объекта.

Для использования глобальной переменной в воронке вам нужно сначала присвоить ее значение любой локальной переменной текущей воронки. Для этого:

1. Добавьте в воронку ноду «Глобальная переменная».
2. Выберите действие «Извлечь переменную».
3. Укажите тип агента, которому была присвоена глобальная переменная.
4. Выберите саму переменную.
5. Установите чекбокс «Сохранить результат в...».

6. Выберите тип агента. Выбранный агент должен присутствовать в текущем событии.
7. Пропишите имя локальной переменной.
8. Нажмите «Применить».

При таких настройках в текущей воронке у указанного агента появится локальная переменная. Вы можете проверять её в условиях на переходах, использовать в тексте сообщений, использовать в других выражениях и так далее.

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

Вам также могут быть полезны статьи:

• Настройки реактивности ноды в воронках
• Как подключить и использовать Telegram в модуле «Воронки»