/
SetLoyalty ◾️ Справочник подстановок

Публичное пространство

SetLoyalty ◾️ Справочник подстановок

Owned by Ксения Лебедева, created
Last updated: февр. 10, 2025
7 min read

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 бонусов.

Список подстановок в редакторе внешних коммуникаций

Подстановки актуальны для всех доступных каналов внешних коммуникаций.

Подстановка

Описание

Пример

Тип рассылок

(если не указан, то любой)

Быстрое копирование

Наведите курсор на подстановку и нажмите image-20240702-131844.png, чтобы скопировать.

Подстановка

Описание

Пример

Тип рассылок

(если не указан, то любой)

Быстрое копирование

Наведите курсор на подстановку и нажмите image-20240702-131844.png, чтобы скопировать.

Анкетные данные

{{Customer.first_name}}

Имя покупателя.

Если имя не указано в анкете, то будет подставлено значение “Покупатель“.

Заданный шаблон:

Здравствуйте, {{Customer.first_name}}!

Пример сообщения для покупателя:

Здравствуйте, Иван!

В тестовом сообщении подстановка заменяется значением Покупатель, если по указанному номеру телефона не найден профиль в базе покупателей (если найден – подставляются реальные данные).

Здравствуйте, Покупатель!

 

{{Customer.first_name}}

{{UnsubscribeURL}}

Ссылка на отписку от рассылки.

При переходе по ссылке:

  • из электронного письма – произойдёт деактивация согласия в анкете "на отправку мобильных сообщений по e-mail".

  • из сообщения по SMS/Viber –произойдёт деактивация согласия в анкете "на отправку мобильных сообщений".

При использовании подстановки обратите внимание, что ссылка может содержать более 30 символов.

Заданный шаблон:

Отписаться от рассылки: {{UnsubscribeURL}}

Пример сообщения для покупателя:

Отписаться от рассылки: https://XXXXXXXX

В тестовом сообщении подстановка заменяется пустой строкой:

Отписаться от рассылки:

 

{{UnsubscribeURL}}

Бонусы

{{BonusBalance.All}}

Бонусный баланс покупателя, суммирующийся по всем счетам.

Учитываются только активированные бонусы (то есть бонусы с актуальным сроком действия, доступные для списания).

Заданный шаблон:

Ваш баланс: {{BonusBalance.All}} бонусов.

Пример сообщения для покупателя:

Ваш баланс: 50 бонусов.

В тестовом сообщении подстановка заменяется значением XXX.XX, если по указанному номеру телефона не найден профиль в базе покупателей (если найден – подставляются реальные данные).

Ваш баланс: XXX.XX бонусов.

 

{{BonusBalance.All}}

{{BonusBalance.id}}

Бонусный баланс покупателя по указанному счёту. Учитываются только активированные бонусы.

Счёт указывается по ID. Например, для подстановки {{BonusBalance.6780525}} “6780525” – это ID бонусного счета. Замените его актуальным значением.

Как узнать ID бонусного счёта

Заданный шаблон:

Ваш баланс: {{BonusBalance.6780525}} бонусов.

Пример сообщения для покупателя:

Ваш баланс: 50 бонусов.

В тестовом сообщении подстановка заменяется значением XXX.XX, если по указанному номеру телефона не найден профиль в базе покупателей (если найден – подставляются реальные данные).

Ваш баланс: XXX.XX бонусов.

 

{{BonusBalance.id}}

{{BalanceTotal.All}}

Бонусный баланс покупателя, суммирующийся по всем счетам.

Учитываются и активированные, и неактивированные бонусы.

Заданный шаблон:

Ваш баланс: {{BalanceTotal.All}} бонусов.

Пример сообщения для покупателя:

Ваш баланс: 50 бонусов.

В тестовом сообщении подстановка заменяется значением XXX.XX, если по указанному номеру телефона не найден профиль в базе покупателей (если найден – подставляются реальные данные).

Ваш баланс: XXX.XX бонусов.

 

{{BalanceTotal.All}}

{{BalanceTotal.id}}

Бонусный баланс покупателя по указанному счёту.

Учитываются и активированные, и неактивированные бонусы.

Счёт указывается по ID. Например, для подстановки {{BalanceTotal.6780525}} “6780525” – это ID бонусного счета. Замените его актуальным значением.

Заданный шаблон:

Ваш баланс: {{BalanceTotal.6780525}} бонусов.

Пример сообщения для покупателя:

Ваш баланс: 50 бонусов.

В тестовом сообщении подстановка заменяется значением XXX.XX, если по указанному номеру телефона не найден профиль в базе покупателей (если найден – подставляются реальные данные).

Ваш баланс: XXX.XX бонусов.

 

{{BalanceTotal.id}}

{{Bonus.Expired}}

Количество сгорающих бонусов.

Учитываются активированные бонусы, у которых заканчивается срок действия через N дней, где N – число дней до сгорания, которое задано в триггере по сгоранию бонусов.

Бонусы будут суммироваться по всем счетам покупателя.

Заданный шаблон:

Через 3 дня сгорят {{Bonus.Expired}} бонусов. Успейте потратить!

Пример сообщения для покупателя:

Через 3 дня сгорят 50 бонусов. Успейте потратить!

В тестовом сообщении подстановка заменяется значением XXX.XX

Через 3 дня сгорят XXX.XX бонусов. Успейте потратить!

Только для рассылок по триггеру По операции с бонусным балансом с заданным параметром:

  • Тип операции → Сгорание бонусов.

 

{{Bonus.Expired}}

{{Bonus.Expired.Date}}

Дата сгорания бонусов.

Заданный шаблон:

Успейте потратить бонусы до {{Bonus.Expired.Date}}!

Пример сообщения для покупателя:

Успейте потратить бонусы до 15.10.2024!

В тестовом сообщении подстановка заменяется значением dd.mm.yyyy

Успейте потратить бонусы до dd.mm.yyyy!

1. Для рассылок по триггеру По операции с бонусным балансом с заданным параметром:

  • Тип операции → Сгорание бонусов.

Подстановка будет заменена датой сгорания активированных бонусов, у которых срок действия заканчивается через N дней, где N – это заданное в настройках триггера количество дней до даты сгорания.

2. Для рассылок по триггеру По операции с бонусным балансом с заданным параметром:

  • Тип операции → Изменение бонусного баланса;

  • Остальные параметры – любые.

Подстановка будет заменена датой сгорания начисленных бонусов (или прочерком “-”, если не было начисления или если начисленные бонусы действуют бессрочно).

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

{{Bonus.Expired.Date}}

{{Bonus.Active}}

Количество бонусов, которые были активированы (то есть количество бонусов, у которых наступил срок действия).

Заданный шаблон:

Активировано {{Bonus.Active}}бонусов. Ждём за покупками!

Пример сообщения для покупателя:

Активировано 50 бонусов. Ждём за покупками!

В тестовом сообщении подстановка заменяется значением XXX.XX

Активировано XXX.XX бонусов. Ждём за покупками!

Только для рассылок по триггеру По операции с бонусным балансом с заданным параметром:

  • Тип операции → Активация бонусов.

 

{{Bonus.Active}}

{{Bonus.Active.Date}}

Дата активации бонусов, у которых ещё не начался срок действия.

Подстановка предназначена для триггерных рассылок о начислении бонусов.

 

Заданный шаблон:

Вам начислены бонусы. Они будут активированы {Bonus.Active.Date}}

Пример сообщения для покупателя:

Вам начислены бонусы. Они будут активированы 15.05.2024

  1. В тестовом сообщении подстановка заменяется значением dd.mm.yyyy

Вам начислены бонусы. Они будут активированы dd.mm.yyyy

  1. Если для покупателя зафиксировано несколько начислений бонусов с разными датами активации, то используется самая поздняя дата активации. Подробнее

Только для рассылок по триггеру По операции с бонусным балансом с возможными параметрами:

  • Тип операции → Изменение бонусного баланса;

  • Фиксировать триггер при → Начислении;

  • Каналы начисления (задан любой из вариантов ниже):

    • через Покупку;

    • через Интерфейс Set Loyalty;

    • через API.

{{Bonus.Active.Date}}

{{Bonus.Add}}

Количество начисленных бонусов.

Заданный шаблон:

Вам начислено {{Bonus.Add}} бонусов.

Пример сообщения для покупателя:

Вам начислено 50 бонусов.

В тестовом сообщении подстановка заменяется значением XXX.XX

Вам начислено XXX.XX бонусов.

Только для рассылок по триггеру По операции с бонусным балансом с возможными параметрами:

  • Тип операции → Изменение бонусного баланса;

  • Фиксировать триггер при (задан любой из вариантов ниже):

    • Начислении;

    • Списании;

    • Начислении или списании;

  • Каналы начисления могут быть указаны любые.

{{Bonus.Add}}

{{Bonus.Out}}

Количество списанных бонусов.

Заданный шаблон:

Списано {{Bonus.Out}} бонусов.

Пример сообщения для покупателя:

Списано 50 бонусов.

В тестовом сообщении подстановка заменяется значением XXX.XX

Списано XXX.XX бонусов.

Только для рассылок по триггеру По операции с бонусным балансом с возможными параметрами:

  • Тип операции → Изменение бонусного баланса;

  • Фиксировать триггер при (задан любой из вариантов ниже):

    • Начислении;

    • Списании;

    • Начислении или списании;

  • Каналы списания могут быть указаны любые.

{{Bonus.Out}}

Как использовать подстановки

Все подстановки вводятся в текст сообщения в двойных фигурных скобках {{ }}. Подстановка, указанная правильно, будет выделяться синим цветом: {{Customer.first_name}}.

Если подстановка введена некорректно, то она подсвечивается красным: {{customer.first_name}}.

image-20240715-120303.png

Общие правила работы

  • Подстановки можно использовать как в теле сообщения, так и в заголовке (при наличии).

  • Одну и ту же подстановку можно использовать в тексте несколько раз.

  • Регистр символов учитывается при вводе подстановки.

  • Все нераспознанные подстановки при отправке сообщений будут отображаться в полученном покупателем сообщении как обычный текст.

  • Некоторые подстановки могут быть использованы только в рассылках по определенному триггеру. Если подстановка введена корректно, но используется вместе с несовместимым триггером, в редакторе выводится предупреждение “В тексте сообщения есть подстановки, которые невозможно использовать с выбранным триггером. Подробнее в справочнике”. Если рассылка с таким предупреждением всё же будет отправлена, то при отправке сообщения подстановка будет заменена на значение “-“ (прочерк). В описании каждой подстановки (таблица выше) вы можете ознакомиться с перечнем триггеров, с которыми выбранная подстановка будет работать корректно.

Дополнительно

Как посмотреть ID бонусного счёта

Посмотреть ID бонусного счёта можно в настройках триггера при редактировании коммуникации:

image-20241119-174209.png

Или в разделе Карты и счета → Счета в окне просмотра/редактирования бонусного счёта:

image-20241119-173740.png

Тестовые сообщения

https://crystals.atlassian.net/browse/SLS-3756

https://crystals.atlassian.net/browse/CR-11922

При создании рассылки вы можете отправить тестовое сообщение на произвольно введенный номер телефона или e-mail. Для того чтобы тестовое сообщение, содержащее подстановки, было наглядным и информативным при получении, используйте номер телефона/e-mail, который привязан к существующему профилю в базе покупателей (и подходящему для проведения теста).

image-20241204-095754.png

Логика работы

При отправке тестового сообщения на указанный номер телефона происходит один из сценариев:

  • если покупатель с таким номером есть в базе, то вместо подстановок в сообщении будут отображаться реальные данные, которые есть в профиле (например: имя, общее количество бонусов на счету). Если значение из профиля получить невозможно (например, количество списанных бонусов), то подставляются специальные тестовые значения.

  • если покупателя с таким номером нет в базе, то вместо подстановок отображаются тестовые значения.

Для e-mail логика аналогичная.

Подстановка

Тестовое значение

Подстановка

Тестовое значение

{{Customer.first_name}}

Покупатель

{{UnsubscribeURL}}

Пустая строка

{{BonusBalance.All}}

XXX.XX

{{BonusBalance.id}}

XXX.XX

{{BalanceTotal.All}}

XXX.XX

{{BalanceTotal.id}}

XXX.XX

{{Bonus.Expired}}

XXX.XX

{{Bonus.Expired.Date}}

dd.mm.yyyy

{{Bonus.Active}}

XXX.XX

{{Bonus.Active.Date}}

dd.mm.yyyy

{{Bonus.Add}}

XXX.XX

{{Bonus.Out}}

XXX.XX

Пример отправки тестового сообщения

В редакторе коммуникаций в шаблоне сообщения задан текст:

{{Customer.first_name}}, успейте потратить {{Bonus.Expired}} бонусов до {{Bonus.Expired.Date}}, иначе они сгорят!
Всего на вашем счету: {{BalanceTotal.All}} бонусов. Ждём за покупками!

В поле Тестовое сообщение на номер маркетолог вводит номер телефона, к которому не привязан ни один профиль в базе покупателей → нажимает кнопку Отправить → получает сообщение:

Покупатель, успейте потратить XХХ.XX бонусов до dd.mm.yyyy, иначе они сгорят!
Всего на вашем счету: XХХ.XX бонусов. Ждём за покупками!

Маркетолог меняет номер телефона на тот, к которому привязан существующий профиль → нажимает кнопку Отправить → получает сообщение:

Анна, успейте потратить XХХ.XX бонусов до dd.mm.yyyy, иначе они сгорят!
Всего на вашем счету: 250 бонусов. Ждём за покупками!

Подстановки {{Customer.first_name}} и {{BalanceTotal.All}} заменены актуальными значениями из профиля.

Примеры сценариев

Пример 1. Несколько начислений бонусов за покупку с разными датами активации

Исходные условия

Запущена коммуникация по триггеру По операции с бонусным балансом с параметрами:

  • Бонусный счет → Все;

  • Тип операции → Изменение бонусного баланса;

  • Фиксировать триггер при начислении.

В редакторе коммуникации задано:

Вам начислено {{Bonus.Add}} бонусов. Они будут активированы {{Bonus.Active.Date}}

Результат

Покупатель совершает покупку, за которую получает начисления:

  • 108 бонусов с датой активации 12.10.24 на бонусный счет Основной;

  • 150 бонусов с датой активации 15.10.24 на бонусный счет Дополнительный.

Покупателю отправлено сообщение:

Вам начислено 258 бонусов. Они будут активированы 15.10.2024

© 1994-2024, ООО «Кристалл Сервис Интеграция».
Все права защищены..

Политика обработки персональных данных