Публичное пространство
SetLoyalty ◾️ Справочник подстановок
https://crystals.atlassian.net/browse/SLS-3509
https://crystals.atlassian.net/browse/CR-11423
https://crystals.atlassian.net/browse/CR-11165
Описание
Подстановка — это переменная, которая будет заменена актуальным значением при отправке сообщения конкретному адресату. Подстановки позволяют персонализировать рассылки, тем самым повышая эффективность коммуникации с аудиторией.
Пример
Запущена рассылка с шаблоном сообщения:
Здравствуйте, {{Customer.first_name}}! У вас {{BonusBalance.All}} бонусов.
Пример полученного сообщения для Ивана Иванова:
Здравствуйте, Иван! У вас 50 бонусов.
Список подстановок редактора коммуникаций
Приведённые в таблице подстановки актуальны для использования:
подстановки №1 – 12: в редакторе внешних коммуникаций для всех доступных каналов: SMS, E-mail, Telegram и других.
подстановки №1 , 3 – 5: в редакторе коммуникаций в торговом зале для всех доступных каналов: дисплей кассира, дисплей покупателя.
№ | Подстановка | Описание | Пример | Область использования Обозначения: | Быстрое копирование Наведите курсор на подстановку и нажмите |
|---|---|---|---|---|---|
Анкетные данные | |||||
1 | {{Customer.first_name}} | Имя покупателя. Если имя не указано в анкете, то будет подставлено значение “Покупатель“. | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется значением Покупатель, если по указанному номеру телефона не найден профиль в базе покупателей (если найден — подставляются реальные данные).
| ✓ Редактор внешних коммуникаций ✓ Редактор коммуникаций в торговом зале | {{Customer.first_name}} |
2 | {{UnsubscribeURL}} | Ссылка на отписку от рассылки. При переходе покупателя по ссылке произойдёт деактивация согласия в анкете на отправку сообщений в соответствующем канале коммуникации. Обратите внимание, что ссылка может содержать более 30 символов. | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется пустой строкой:
| ✓ Редактор внешних коммуникаций ✘ Редактор коммуникаций в торговом зале | {{UnsubscribeURL}} |
Бонусы | |||||
3 | {{BonusBalance.All}} | Бонусный баланс покупателя, суммирующийся по всем счетам. Учитываются только активированные бонусы (то есть бонусы с актуальным сроком действия, доступные для списания). | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется значением XXX.XX, если по указанному номеру телефона не найден профиль в базе покупателей (если найден — подставляются реальные данные).
| ✓ Редактор внешних коммуникаций ✓ Редактор коммуникаций в торговом зале | {{BonusBalance.All}} |
4 | {{BonusBalance.id}} | Бонусный баланс покупателя по указанному счёту. Учитываются только активированные бонусы. Счёт указывается по ID. Например, для подстановки {{BonusBalance.6780525}} “6780525” — это ID бонусного счета. Замените его актуальным значением. | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется значением XXX.XX, если по указанному номеру телефона не найден профиль в базе покупателей (если найден — подставляются реальные данные).
| ✓ Редактор внешних коммуникаций ✓ Редактор коммуникаций в торговом зале | {{BonusBalance.id}} |
5 | {{BalanceTotal.All}} | Бонусный баланс покупателя, суммирующийся по всем счетам. Учитываются и активированные, и неактивированные бонусы. | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется значением XXX.XX, если по указанному номеру телефона не найден профиль в базе покупателей (если найден — подставляются реальные данные).
| ✓ Редактор внешних коммуникаций ✓ Редактор коммуникаций в торговом зале | {{BalanceTotal.All}} |
6 | {{BalanceTotal.id}} | Бонусный баланс покупателя по указанному счёту. Учитываются и активированные, и неактивированные бонусы. Счёт указывается по ID. Например, для подстановки {{BalanceTotal.6780525}} “6780525” — это ID бонусного счета. Замените его актуальным значением. | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется значением XXX.XX, если по указанному номеру телефона не найден профиль в базе покупателей (если найден — подставляются реальные данные).
| ✓ Редактор внешних коммуникаций ✓ Редактор коммуникаций в торговом зале | {{BalanceTotal.id}} |
7 | {{Bonus.Expired}} | Количество сгорающих бонусов. Учитываются активированные бонусы, у которых заканчивается срок действия через N дней, где N — число дней до сгорания, которое задано в триггере по сгоранию бонусов. Бонусы будут суммироваться по всем счетам покупателя. | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется значением XXX.XX
| ✔ Редактор внешних коммуникаций ✘ Редактор коммуникаций в торговом зале Только для коммуникаций по триггеру По операции с бонусным балансом с заданным параметром:
| {{Bonus.Expired}} |
8 | {{Bonus.Expired.Date}} | Дата сгорания бонусов. | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется значением dd.mm.yyyy
| ✔ Редактор внешних коммуникаций ✘ Редактор коммуникаций в торговом зале Только для коммуникаций по триггеру По операции с бонусным балансом с возможными параметрами:
Подстановка будет заменена датой сгорания активированных бонусов, у которых срок действия заканчивается через N дней, где N — это заданное в настройках триггера количество дней до даты сгорания.
Подстановка будет заменена датой сгорания начисленных бонусов (или прочерком “-”, если не было начисления или если начисленные бонусы действуют бессрочно). Если в чеке совершено несколько бонусных транзакций с разными датами начисления, то подставляется самая ближайшая дата. | {{Bonus.Expired.Date}} |
9 | {{Bonus.Active}} | Количество бонусов, которые были активированы (то есть количество бонусов, у которых наступил срок действия). | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется значением XXX.XX
| ✔ Редактор внешних коммуникаций ✘ Редактор коммуникаций в торговом зале Только для коммуникаций по триггеру По операции с бонусным балансом с заданным параметром:
| {{Bonus.Active}} |
10 | {{Bonus.Active.Date}} | Дата активации бонусов, у которых ещё не начался срок действия. Подстановка предназначена для триггерных рассылок о начислении бонусов.
| Заданный шаблон:
Пример сообщения для покупателя:
| ✔ Редактор внешних коммуникаций ✘ Редактор коммуникаций в торговом зале Только для коммуникаций по триггеру По операции с бонусным балансом с возможными параметрами:
| {{Bonus.Active.Date}} |
11 | {{Bonus.Add}} | Количество начисленных бонусов. | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется значением XXX.XX
| ✔ Редактор внешних коммуникаций ✘ Редактор коммуникаций в торговом зале Только для коммуникаций по триггеру По операции с бонусным балансом с возможными параметрами:
| {{Bonus.Add}} |
12 | {{Bonus.Out}} | Количество списанных бонусов. | Заданный шаблон:
Пример сообщения для покупателя:
В тестовом сообщении подстановка заменяется значением XXX.XX
| ✔ Редактор внешних коммуникаций ✘ Редактор коммуникаций в торговом зале Только для коммуникаций по триггеру По операции с бонусным балансом с возможными параметрами:
| {{Bonus.Out}} |
Условия в тексте сообщений
Область применения
Доступно только в редакторе внешних коммуникаций для всех каналов, кроме VK и OK (ВКонтакте и Одноклассники).
Не поддерживается для коммуникаций в торговом зале.
Условия — это логические конструкции в тексте сообщения, которые позволяют динамически включать или исключать фрагменты текста в зависимости от наличия определённых данных. Цель использования — оптимизировать создание рассылок.
Например, триггерную рассылку об изменении бонусного баланса можно настроить следующим образом:
Если бонусы списаны — отображать сумму списания.
Если начислены — отображать информацию о начислении.
Если произошло и списание, и начисление — отображать оба блока.
Таким образом, одно гибкое сообщение заменяет несколько шаблонов, а покупатели получают только релевантную информацию (подробнее описано в сценарии 2).
Условие “Если – То”
Условие имеет вид:
{@ If подстановка @}
... (текст и/или подстановки, которые отобразятся, если условие будет выполнено)
{@ endif @}
Оно состоит из трёх компонентов:
Начало условия:
{@ If подстановка @}(например,{@ If Bonus.Add @}).Содержимое, которое выводится при выполнении условия.
Конец условия:
{@ endif @}.
Как работает условие:
если подстановка содержит данные, условие выполняется — текст внутри конструкции будет отображаться в отправленном сообщении.
если подстановка не содержит данные, условие не выполняется — текст внутри условий не будет отображаться в отправленном сообщении.
При указании условий можно использовать любые подстановки, доступные в системе.
Пример
В шаблоне сообщения задано:
{@ If Bonus.Add @}
Вам начислено {{Bonus.Add}} бонусов.
{@ endif @}
Ваш баланс: {{BonusBalance.All}} бонусов
Если Bonus.Add = 50 (то есть значение не пустое), в отправляемом сообщении отобразится информация о начислении:
Вам начислено 50 бонусов.
Ваш баланс: 150 бонусов
Если отсутствует значение Bonus.Add, текст внутри условия не отобразится в отправляемом сообщении:
Ваш баланс: 150 бонусов
Правила ввода подстановок и условий
Все подстановки вводятся в текст сообщения в двойных фигурных скобках {{ }}.
Корректно введённая подстановка будет выделяться синим цветом: {{Customer.first_name}}, некорректная — красным: {{customer.first_name}}.
Условия подсвечиваются оранжевым, если введены корректно, красным — если некорректно.
Особенности работы
Подстановки и условия можно использовать как в теле сообщения, так и в заголовке (при наличии).
Одну и ту же подстановку можно использовать в тексте несколько раз.
Регистр символов учитывается при вводе подстановок и условий.
Все нераспознанные подстановки и условия при отправке сообщений будут отображаться в полученном покупателем сообщении как обычный текст.
Вложенность условий не поддерживается: не размещайте одно условие внутри другого.
Некоторые подстановки могут быть использованы только в рассылках по определенному триггеру. Если подстановка введена корректно, но используется вместе с несовместимым триггером, в редакторе выводится предупреждение “В тексте сообщения есть подстановки, которые невозможно использовать с выбранным триггером. Подробнее в справочнике”. Если рассылка с таким предупреждением всё же будет отправлена, то при отправке сообщения подстановка будет заменена на значение “-“ (прочерк). В описании каждой подстановки (таблица выше) вы можете ознакомиться с перечнем триггеров, с которыми выбранная подстановка будет работать корректно.
Дополнительно
Как посмотреть ID бонусного счёта
Посмотреть ID бонусного счёта можно в настройках триггера при редактировании коммуникации:
Или в разделе Карты и счета → Счета в окне просмотра/редактирования бонусного счёта:
Тестовые сообщения
https://crystals.atlassian.net/browse/SLS-3756
https://crystals.atlassian.net/browse/CR-11922
При создании рассылки в разделе внешних коммуникаций вы можете отправить тестовое сообщение на произвольно введенный номер телефона или e-mail. Для того чтобы тестовое сообщение, содержащее подстановки, было наглядным и информативным при получении, используйте номер телефона/e-mail, который привязан к существующему профилю в базе покупателей (и подходящему для проведения теста).
Логика работы
При отправке тестового сообщения на указанный номер телефона происходит один из сценариев:
если покупатель с таким номером есть в базе, то вместо подстановок в сообщении будут отображаться реальные данные, которые есть в профиле (например: имя, общее количество бонусов на счету). Если значение из профиля получить невозможно (например, количество списанных бонусов), то подставляются специальные тестовые значения.
если покупателя с таким номером нет в базе, то вместо подстановок отображаются тестовые значения.
Для e-mail логика аналогичная.
© 1994-2025, ООО «Кристалл Сервис Интеграция».
Все права защищены.