Что такое Preprocessor

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

 

С препроцессором всё это можно реализовать без интеграции с третьим сервисом, рутинным и бесполезным обновлением дополнительных полей контакта и использовать как в массовых рассылках, так и в триггерных письмах.

Кстати, пользоваться персонализацией можно не только в письмах, но и в SMS сообщениях. 

 

Возможности Препроцессора очень широки и не ограничиваются существующим функционалом. Мы легко можем расширять их добавляя новую логику обработки внешних массивов данных. Так что если кому-то нужно “странное” пишите, обсудим и постараемся в короткие сроки реализовать ваши потребности.

 

 

Поддерживаемые типы

Сейчас для публичного использования доступны такие типы препроцессора:

• Key 
• Random

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

 

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

 

{“test1@mail.com” : [{...}, {...}], “test2@mail.com” : [{...}, {...}, {...}], “test3@mail.com” : [{...}, {...}]}, 

 

где test1@mail.com, test2@mail.com, test3@mail.com - емейл-адрес (или номер телефона) получателя, каждому из которых соответствует массив данных для подстановки в письмо.

 

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

 

{“test@mail.com” : [{...}, {...}, {...}, {...}, {...}, {...}]},

 

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

 

При отправке письма препроцессор определяет, какую именно структуру данных передать в письмо. Если используется тип Key - передаётся структура, заданная для конкретного получателя; если используется тип Random - структура определяется случайным образом. Результирующий массив данных можно использовать в письме с помощью специальных инструкций, заданных в виде кода. Эти инструкции включают в себя условные операторы и циклы, что позволяет достаточно гибким образом отобразить динамический контент в теле письма.

 

Примечание. Препроцессор также можно использовать и для SMS-рассылок. Принципы его работы для SMS остаются теми же.

 

 

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

Для вставки динамического контента в письмо используется специальный процессор шаблонов - Apache Velocity. Именно он позволяет реализовать условные операторы, циклы и другие операции над данными непосредственно в теле письма. Весь динамический контент, доступный при отправке, находится в специальной системной переменной $data. После загрузки файла - его нужно выбрать при формировании письма. Для этого:

• после создания письма, в редакторе сообщений нажмите "Показать настройки";
  
  
   
• затем выбираем тип препроцессора (для примера мы выбирали тип Key, для добавления файла препроцессора типа Random - проводятся аналогичные действия);
  
  
   
• выбираем загруженный на прошлом этапе файл
  
   

Таким образом, загруженный на предыдущем этапе файл, будет использован при отправки текущего письма.

Определённый препроцессором массив данных размещается в массиве с названием “recommendations”. Чтобы получить к нему доступ, используйте такую конструкцию:

$data.get(‘recommendations’)

Чтобы организовать цикл по этому массиву, пишите так:
#foreach($item in $data.get(‘recommendations’))
$item.get(‘name’)
…
#end

Название переменной $item может быть произвольным, а вот поле с названием “name” должно содержаться у каждого элемента в файле с данными, если вы собираетесь обратиться к нему в письме по такому названию.

Условную операцию также сделать несложно:

#if($item.get(‘discount’) == 0)
    …
#else
    …
#end

Вместо троеточий в обоих случаях вы можете подставить произвольный фрагмент html-кода (соблюдая при этом общую его целостность в рамках письма).

Если у вас возникнут проблемы с формированием velocity-кода в письме или у вас есть вопросы по более сложным примерам его использования, чем описанные в этом разделе - обращайтесь в нашу службу поддержки support@esputnik.com. Мы будем рады оказать помощь и поделиться знаниями.

 

Как протестировать данные для рассылок

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

Из уже доступных возможностей для тестирования можем предложить рассылку на тестовую группу. Для препроцессора типа Key вам необходимо сформировать группу из нескольких контактов, емейлы которых содержатся в файле с данными; затем выбрать нужный файл в сообщении и запустить рассылку на эту группу. В случае с препроцессором типа Random дополнительно беспокоиться о наличии адресов в файле нет необходимости - можно тестировать на любые адреса.

 

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

Обращение к элементам по индексу

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

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

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

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

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