Переменные — это атрибут, в который подставляются индивидуальные данные пользователя или связанного с ним объекта (например, заказ, покупка и т.д.)
Переменные в процессах обычно применяются для следующих операций:
- «Вопрос менеджеру»
- «Уведомить партнера»
- «Уведомить сотрудника»
- «Отправить сообщение»
- «Вызвать URL»
Крайне важно указывать переменные в процессах в правильном формате, чтобы корректно подставлялись данные о пользователях, заказах и других объектах.
В этой статье вы узнаете, как правильно использовать переменные:
- В процессах по пользователям
- В процессах по заказам
- В процессах по покупкам
- По партнерам
- По персональному менеджеру
- По источнику пользователя или по источнику заказа
- По дополнительным полям
- По промокоду из заказа
- Для вывода дат
- Созданные самостоятельно
- Сложной автозамены
- В рассылках, отправляемых из процесса
Как использовать переменные в процессах по пользователям
В процессах по пользователям переменные следует указывать в фигурных скобках с приставкой object:
| {object.first_name} | Имя пользователя |
|---|---|
| {object.email} | Электронная почта пользователя |
| {object.phone} | Телефон пользователя |
| {object.city} | Город пользователя |
Как использовать переменные в процессах по заказам
В процессах по заказам доступны переменные:
- заказу,
- пользователю, которому принадлежит заказ.
Для использования переменных по заказуДобавьте к ним префикс object:
{object.number} — идентификатор заказа.
{object.positions} — Состав заказа.
{object.payment_link} — Платежная ссылка.
{object.offers} — Состав заказа: идентификаторы предложений (ID).
{object.promocode} — промокод, применённый в заказе.
{object.cost_money} — цена заказа с указанной валютой.
{object.funnel_id} — идентификатор доски продаж, на которой находится заказ.
{object.funnel_stage_id} — идентификатор этапа на доске продаж, где находится заказ.
Чтобы использовать переменные, связанные с пользователем, в процессе заказаДобавьте приставки object и user:
{object.user.first_name} — имя пользователя.
{object.user.email} — адрес электронной почты пользователя.
{object.user.phone} — номер телефона пользователя.
{object.user.city} — город, указанный пользователем.
Переменная для вывода основного домена аккаунта {maindomain} является пользовательской переменной. Поэтому при её использовании в процессах по заказам необходимо применять аналогичную конструкцию, т.е.{object.user.maindomain}.
Как использовать переменные в процессах по покупкам
В процессах покупок доступны переменные:
- покупке,
- пользователю, которому принадлежит покупка.
Для использования переменных при покупкеДобавьте к ним префикс object:
| {object.start_at} | Дата начала |
|---|---|
| {object.finish_at_ago} | Время до окончания |
| {object.state} | Текущее состояние покупки |
Чтобы в процессе покупок использовать переменные, привязанные к пользователюДобавьте приставки object и user:
| {object.user.first_name} | Имя пользователя |
|---|---|
| {object.user.email} | Электронная почта пользователя |
| {object.user.phone} | Телефон пользователя |
| {object.user.city} | Город пользователя |
Переменная, предназначенная для вывода основного домена аккаунта {maindomain}, является переменной, ориентированной на пользователей. Поэтому при её использовании в процессах покупки следует применять конструкцию — {object.user.maindomain}.
Формат переменных по партнеру
Чтобы подставлять данные партнёра, применяйте приставки object, user и partner в переменных.
В процессах по пользователям переменная будет иметь вид:
- {object.partner.email}
В процессах по покупкам применяйте дополнительную приставку user для передачи данных владельца покупки:
- {object.user.partner.email}
В процессах по заказам можно передавать сведения о партнере пользователя и партнере заказа:
- Партнер в заказе: {object.partner.email};
- {object.user.partner.email} является партнером пользователя.
Ниже приведён полный перечень переменных, доступных партнеру:
| {partner.uid} | Идентификатор партнёра |
|---|---|
| {partner.first_name} | Имя партнёра |
| {partner.last_name} | Фамилия партнёра |
| {partner.real_name} | Русскоязычное имя партнёра, созданное автоматически |
| {partner.email} | Эл. адрес партнёра |
| {partner.phone} | Номер телефона партнёра |
| {partner.created_at} | Дата регистрации партнёра |
Формат переменных по персональному менеджеру
В процессах можно использовать переменные для персонального менеджера пользователя:
- {personal_manager} — имя менеджера;
- {personal_manager_email} — email менеджера;
- {personal_manager_phone} — телефон менеджера.
Чтобы подставить контакты менеджера, внесите их в разделе «Партнерская программа»:
- Электронная почта, с которой отправляются письма клиентам. Если поле не видно в профиле персонального менеджера, настройте доменную почту в вашем аккаунте.
- Имя отправителя. Если поле остается пустым, значение переменной {personal_manager} будет подтянуто из профиля менеджера.
- Добавочный номер телефона.
Для этих переменных не требуются приставки object или object.user.
Формат переменных по источнику пользователя или источнику заказа
Эти переменные позволяют передавать UTM-метки и другие параметры из ссылки, по которой осуществляется регистрация пользователя или создается заказ.
Переменные источника формируются с использованием приставок object, user и create_session.
В процессах по пользователям переменные оформлены по следующему формату:
- {object.create_session.utm_source}
В процессах, связанных с заказами и покупками Применяйте дополнительную приставку user.
- {object.user.create_session.utm_source}
Для передачи UTM-меток применяются следующие переменные:
- {create_session.utm_source}
- {create_session.utm_medium}
- {create_session.utm_campaign}
- {create_session.utm_content}
- {create_session.utm_term}
- {create_session.utm_group}
Если ссылка содержит дополнительные параметры, их можно передать, указав имя параметра как переменную:
- {create_session.gcpc} — партнёрский код;
- {create_session.clickid} — произвольный параметр, полученный из источника пользователя.
Формат переменных по дополнительным полям
Для создания переменной используется заголовок дополнительного поля. Затем добавьте к полученной переменной приставки для корректной работы процесса.
В процессах невозможно применять данные из дополнительных полей покупки через переменные.
Подбор приставок определяется типом объекта, для которого создано дополнительное поле:
- Дополнительные поля пользователя обрабатываются как переменные для пользователя;
- дополнительные поля заказа обрабатываются как переменные заказа.
Далее рассмотрим примеры использования переменных.
Для этого применяем заголовки дополнительных полей:
- «Часовой пояс» — это дополнительное поле пользователя;
- «Дата консультации» является дополнительным полем заказа.
В процессе по пользователям используйте дополнительные пользовательские поля с префиксом object:
- {object. Часовой пояс}
В процессе по заказам Примените приставку object для дополнительного поля заказа:
- {object. Дата консультации}
Чтобы передать дополнительное пользовательское поле, применяйте префиксы object и user:
- {object.user. Часовой пояс}
Для корректного функционирования переменных не применяйте точки в названиях дополнительных полей.
Переменная для передачи промокода из заказа
Для передачи названия промокода, применённого в заказе, используйте переменную {object.promocode} при работе с объектом «Заказы».
Формат переменных для вывода дат
Доступны следующие переменные для вывода дат:
- {today} — показывает сегодняшнюю дату;
- {today plus} — возвращает сегодняшнюю дату с добавлением Х дней;
- {nextweekday} — переменная возвращает дату ближайшего указанного дня недели.
Для этих переменных не требуются приставки object или object.user.
Формат переменных, созданных вами самостоятельно
Вы можете использовать в процессах собственные переменные, созданные в разделе «Сайт» — «Страницы» — «Переменные».
При добавлении переменной в блок процесса не нужно добавлять приставку object или object.user. Придерживайтесь того же формата, который указан в переменной изначально.
Формат переменных сложной автозамены
В процессах, как и в рассылках, можно применять переменные для сложной автозамены:
- {first_name delimiter="," letter="п"}ривет
Если в профиле указано имя пользователя, то оно автоматически подставляется в сообщение или уведомление. Если имя отсутствует, отправляется только «Привет!».
- {first_name delimiter="," word="здравствуйте"}
Если в профиле пользователя указано имя, оно автоматически подставляется в сообщение или уведомление. Если имя отсутствует, отправляется только «Здравствуйте».
- {gender male="он" female="она" other="оно"} или же Сдел{gender male="ал" female="ала" other="ало"}
Используя эту переменную, вы можете задать, какую форму глагола применять в тексте в зависимости от пола в профиле. Например, «оформил» или «оформила».
При работе со сложными переменными не нужно указывать приставку object или object.user.
Переменные в рассылках, которые отправляются из процесса
В рассылках, независимо от метода отправки, применяются имена переменных без дополнительного форматирования, например:
- {email},
- {positions}.
В постах канала показываем, как цифры превращаются в решения: где реально идёт выручка, а где утечки. «Один график в боте экономит часы споров». Больше коротких приёмов и кейсов внутри.
авторизуйтесь