Как использовать персонализацию

Способы подстановки персонализации в системе eSputnik


1. Описание работы функционала Персонализация

Персонализация - это переменная в теле сообщения, вместо которой при рассылке будет подставлено значение из карточки контакта.

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

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

  • Имени, фамилии получателя;

  • Город или страну;

  • Комбинировать обращение к получателю, например, “уважаемая” или ”уважаемый” и имя клиента;

  • Промокод или ссылку на QR код;

  • Имя закрепленного менеджера, его должность, адрес, емейл и контактный телефон магазина или заведения;

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

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

Больше вариантов персонализации, которые возможно использовать в письмах, можно найти в Личном кабинете - Настройки - Дополнительные поля.

Персонализация в письмах

Все указанные переменные можно использовать в email, viber, sms, а также web push и мобильных push уведомлениях, данные из любого поля контакта могут быть добавлены в тело сообщения при помощи специализированного меню.
 

2. Расположение меню персонализации в редакторах сообщений

Интерфейс редакторов viber, sms, а также web push и мобильных push уведомлений схож. Поэтому пиктограмма добавления персонализации расположена в указанных редакторах в идентичных разделах и при клике - отображает в выпадающем списке перечень доступных полей.

Расположение блоков с персонализацией

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

Поле персонализации в емейл-редакторе

Ниже представлен способ добавления переменной %FIRSTNAME|% в редакторе email сообщений.

Добавление персонализации

3. Пример использования переменной персонализации

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

С одной стороны это удобно, но не редки случаи, когда вместо персонального приветствия вы получаете следующее: “Здравствуйте, !”. Очевидно, что после запятой находилась переменная персонализации, но имя получателя неизвестно и подстановка проигнорирована. Это можно легко исправить.

При добавлении любой переменной, (например %FIRSTNAME|%) после FIRSTNAME следует символ: « | ».

После символа « | » укажите альтернативные данные, которые будут подставлены при отсутствии основных.

Что же это значит на практике, рассмотрим на примере двух случаев, где в первом нам известно имя получателя, а во втором - нет.

Персонализация:

Здравствуйте, %FIRSTNAME|уважаемый клиент%!

Результаты подстановки в письме:

с данными:

Здравствуйте, Алексей!

без данных:

Здравствуйте, уважаемый клиент!


Разумеется, что такой способ подстановки не панацея при полном отсутствии клиентских данных, его назначение - сгладить незначительное их отсутствие. Поэтому не забывайте актуализировать свою контактную базу, регулярно ее пополнять и обновлять. Сделать это можно при помощи процедуры импорта или же настроив интеграцию с нашим сервисом по API.

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

Обращение к клиентам

Для подстановки ссылки на изображение нужно выделить подготовленный блок и в панели меню вместо пути к картинке указать переменную персонализации. В данном примере это %PERSONAL.QRCODE%.

Подстановка персонализации

Или же в режиме редактирования кода письма записать переменную в атрибут изображения src.

Персонализация в коде письма

Важный момент: ссылка на изображение должна содержать в себе полный путь, включая протокол, например так: https://example.com/qr_code.png

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

Письмо с использованием подстановок

4. Применение персонализации совместно с velocity кодом

Использование переменных в теле сообщения позволит во многом унифицировать, если не все письмо, то как минимум его отдельно взятые блоки.

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

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

Письмо без подстановки промокода

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

Для этого вам понадобится овладеть некоторыми навыками использования языка velocity.

В рамках данного примера потребуется разобраться в применении оператора выбора - if else и операторов сравнения.

Для начала необходимо в начале письма объявить использование дополнительных полей, внутри тега комментария. Это может быть самая первая структура в письме, до непосредственного взаимодействия со значением поля.

<!--%PERSONAL.PROMOCODE%-->

<!--%PERSONAL.QRCODE%-->

Затем выделить нужную структуру и перейти в режим редактирования кода письма:

Использование Velocity для рассылки

Затем добавляем наш код:

<!--//Объявление использования дополнительных полей PERSONAL.PROMOCODE и PERSONAL.QRCODE-->

<!--%PERSONAL.PROMOCODE%-->

<!--%PERSONAL.QRCODE%-->

<!--//Проверяем, что значения проверяемых полей не равняются пустой строке-->

<!--#if($!data.get('PERSONAL.PROMOCODE')!='' and $!data.get('PERSONAL.QRCODE')!='')-->

… html код структуры

<!--#end-->

чтобы получилось так, как показано на скриншоте:

Переменные в коде письма

Вставки velocity кода “обернуты” тегами комментария чтобы визуально не нарушалась верстка сообщения в редакторе. Скрывать блоки в случае отсутствия данных не единственное применение if else оператора.
Рассмотрим несколько примеров взаимодействия переменных персонализации и velocity:

а) Проверяем заполнено ли поле контакта с именем.

<!--%FIRSTNAME%-->

<!--//Проверяем, что значение поля FIRSTNAME не равняются пустой строке-->

#if($data.get('FIRSTNAME') and $data.get('FIRSTNAME')!='')

<!--//Если поле не пустое, выводим: Здравствуйте, Имя-->

Здравствуйте, $!data.get('FIRSTNAME').

#else

<!--//Если поле не содержит данных, выводим только: Здравствуйте. -->

Здравствуйте.

#end

б) Осуществляем проверку принадлежности email адреса к домену @gmail.com и отображает соответствующий контент в письме.

<!--%EMAIL%-->

<!--#if($!data.get('EMAIL').contains('@gmail.com'))-->

<!--//html код для получателей, у кого почта в доменной зоне gmail.com-->

<!--#else-->

<!--//html код для остальных получателей-->

<!--#end-->

в) Проверяем пол контакта и формируем корректное обращение к получателю.

<!--//Объявляем использование поля, где указан пол контакта-->

<!--%PERSONAL.GENDER%-->

<!--//Проверяем, не пустое ли поле-->

<!--#if($data.get('PERSONAL.GENDER').equals(''))-->

<!--//Если пол не указан, не используем обращение-->

<!--#set($refBy='.')-->

<!--//Проверяем, если получатель мужчина-->

<!--#elseif($data.get('PERSONAL.GENDER').equals('м') or $data.get('PERSONAL.GENDER').equals('М'))-->

<!--//Подставляем: уважаемый-->

<!--#set($refBy=', уважаемый')-->

<!--//Проверяем, если получатель женщина-->

<!--#elseif($data.get('PERSONAL.GENDER').equals('ж') or $data.get('PERSONAL.GENDER').equals('Ж'))-->

<!--//Подставляем: уважаемая-->

<!--#set($refBy=', уважаемая')-->

<!--#end-->

Персонализация:

Здравствуйте$!refBy %FIRSTNAME%

Результаты подстановки в письме:

для мужчины:

Здравствуйте, уважаемый Алексей

для женщины:

Здравствуйте, уважаемая Виктория

пол не указан:

Здравствуйте.

Таким образом комбинируя данные пользователя из его карточки контакта и применяя оператор выбора if else можно гибко управлять содержимым отправляемого сообщения.