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

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

Owned by Ксения Лебедева, created
Last updated: дек. 05, 2024
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 бонусов.

 

{{BalanceTotal.All}}

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

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

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

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

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

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

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

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

 

{{BalanceTotal.id}}

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

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

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

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

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

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

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

 

{{Bonus.Expired}}

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

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

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

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

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

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

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

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

 

{{Bonus.Expired.Date}}

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

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

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

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

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

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

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

{{Bonus.Active}}

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

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

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

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

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

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

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

 

{{Bonus.Active.Date}}

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

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

 

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

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

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

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

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

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

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

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

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

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

    • через API.

{{Bonus.Add}}

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

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

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

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

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

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

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

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

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

    • Списании;

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

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

{{Bonus.Out}}

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

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

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

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

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

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

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

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

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

    • Списании;

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

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

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

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

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

image-20240715-120303.png

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

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

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

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

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

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

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

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

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

image-20241119-174209.png

Или в разделе Карты и сч