Переменные в профиле контакта и возможности Velocity

Самый простой и широко используемый пример персонализации – во время отправки автоматически производится замена переменной %FIRSTNAME% на имя клиента. Имя подставляется только в том случае, если соответствующее поле заполнено в карточке контакта.

По такому же принципу при помощи переменных можно автоматически подставлять следующие значения:

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

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

Больше вариантов персонализации для использования в письмах можно найти в Личном кабинете → Настройки → Дополнительные поля. В дополнительных полях может содержаться абсолютно любая информация о клиенте, которую вы передаете в eSputnik по API.

Все указанные в допполях переменные можно использовать в email, Viber, SMS, а также web push и мобильных push-уведомлениях.

Данные из любого поля контакта могут быть добавлены в тело сообщения при помощи специального меню в редакторе eSputnik.

Подробнее об использовании переменных профиля >

Оптимизация использования переменных с функциями Velocity

Использование переменных из профиля контакта может быть сопряжено с некоторыми трудностями. Например, вам может понадобиться отображать разные блоки сообщений в зависимости от контактных данных. Или скрыть определенные блоки, если данные отсутствуют. Решить эту задачу помогут возможности velocity.

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

Задача

В профиле контакта имеется дополнительное поле PERSONAL.LOCATION. В зависимости от данных в этом поле в письме нужно выводить разные блоки:

• Если PERSONAL.LOCATION = Мальдивы — показывать блок с описанием этой локации и не показывать блок с описанием Тосканы.
• Если PERSONAL.LOCATION = Тоскана — показывать блок с описанием этой локации и не показывать блок с описанием Мальдив.
• Если PERSONAL.LOCATION ≠ Мальдивы или Тоскана — не показывать ни один из этих блоков.

Решение

1. Нажмите на первую структуру в письме, в которой вы хотите отобразить динамический контент (Тоскана), и откройте редактор кода.

2. Найдите первый тег tr в коде структуры.

3. Над тегом tr объявите переменные, которые будут использоваться в письме. В нашем случае это

<!--%PERSONAL.LOCATION%-->

4. Добавьте в код структуры условный оператор, отвечающий за отображение этой структуры. Используйте следующий формат:

<!--#if($data.get('parameter name')=='value1')-->

В нашем случае оператор будет таким:

<!--#if($data.get('PERSONAL.LOCATION')=='Tuscany')-->

5. Кликните на вторую структуру в шаблоне, в которой нужно отобразить динамический контент (Мальдивы). Код этой структуры будет показан в редакторе кода.

6. Найдите первый тег tr в коде структуры.

7. Добавьте условный оператор, отвечающий за отображение этой структуры, в код структуры над тегом tr. Используйте следующий формат:

<!--##elseif($data.get('parameter name')=='value2')-->

В нашем случае оператор будет таким:

<!--#elseif($data.get('PERSONAL.LOCATION')=='Maldives')-->

8. Добавьте <!--#end--> оператор после закрывающего структуру тега /tr.

Результат

Контакты с разными параметрами PERSONAL.LOCATION увидят такие варианты сообщения:

1) Пользователь с параметром Тоскана:

2) Пользователь с параметром Мальдивы:

3) Пользователь с пустым параметром PERSONAL.LOCATION: