Персонализация (метапеременные)
- Метапеременные в Campaign
- Виды метапеременных
- Создание метапеременных
- Использование метапеременных в коммуникациях
- Особенности генерации штрихкодов для email в Manzana Campaign
- Метапеременные для подстановки товаров в письмо
Метапеременные в Campaign
Manzana Campaign предоставляет возможность добавлять динамический контент в сообщения, то есть использовать метапеременные или персонализацию.
Для этого используется блок с метапеременными, где перечислены все возможные для использования метапеременные. Каждая из них несет в себе определенную информацию об участнике программы лояльности, которая будет подставлена в сообщение вместо слова-заменителя.
Работа с метапеременными производится при настройке шаблона коммуникации (или из самого шаблона, или на шаге коммуникации).
Например, есть возможность использовать метапеременную [%Имя%] при составлении шаблона сообщения для того, чтобы обратиться к каждому клиенту персонально, если значение его имени записано в CRM.

Список метапеременных может пополняться необходимыми значениями по запросу, для этого необходимо обратиться к менеджеру проекта.
Важно:
1) В качестве метапеременных можно использовать только те данные, которые есть в системе.
2) При использовании метапеременных подсчет символов в системе производится исходя из количества символов, соответствующих выбранной метапеременной. Рекомендуется учитывать данный момент при составлении сообщения, особенно в канале SMS. Так, например, метапеременная «Имя» рассчитывается системой как 7 символов, хотя значения из CRM могут варьироваться в зависимости от контактных данных пользователя. При организации отправки система автоматически меняет значение метапеременной на значение из CRM, в процессе данной подмены «Имя» превращается в конкретное обращение к клиенту – Ирина (5 символов), Алевтина (8 символов). Метапеременная «Количество сгораемых бонусов» рассчитываемая системой как 34 символа, будет заменена на конкретное число бонусов – 100 (3 символа).
Виды метапеременных
Общие – стандартные метапеременные, которые несут в себе одно конкретное значение из CRM. Не требуют дополнительной настройки и сразу готовы к использованию.
Параметризуемые – метапеременные, в которых можно указать дополнительные условия отбора. Например, вам нужно подставить в коммуникацию купоны клиента, но не все, а только определенного выпуска и с истекающей датой сгорания. Тогда можно использовать параметризуемую метапеременную, внутри которой задаются необходимые условия. Параметризуемые переменные обозначаются значком «шестеренка» 
в конце их наименования и требуют дополнительной настройки условий.
Список и описание общих и параметризуемых метапеременных можно найти в документе по ссылке.
Событийные – метапеременные, которые позволяют подставлять в коммуникацию параметры приходящего события в качестве динамического контента. Используются для быстрого информирования клиента об изменениях, которые поступают в Manzana Campaign в событиях, например:
- изменении статуса заказа,
- подтверждение записи на услугу,
- информирование о начислении баллов за совершенную покупку,
- повышении уровня контакта в программе лояльности и т.д.
Создание метапеременных
Стандартный набор общих и параметризуемых метапеременных, которые наиболее часто используются в рассылках, доступен в текстовой части шаблонов коммуникаций всем партнерам, работающим с Manzana Campaign. При необходимости создать для конкретного проекта новую метапеременную вида общая или параметризуемая необходимо обращаться к менеджеру проекта для оценки стоимости и сроков ее разработки. Партнеры не создают общие и параметризуемые метапеременные самостоятельно, это делают специалисты Campaign. Однако у партнеров есть возможность без дополнительных доработок использовать метапеременные из универсального импорта. Подробнее этот функционал описан в подразделе ниже.
Событийные метапеременные пользователи Manzana Campaign создают самостоятельно. Для этого нужно перейти в раздел “Настройки”, подраздел “Метапеременные для событий” и нажать кнопку “Создать”.

В открывшемся окне редактора необходимо задать следующие характеристики создаваемого события:
1) Название – это название метапеременной. Оно отображается в шапке страницы, используется при поиске в списке событийных метапеременной в разделе “Метапеременные для событий”. Также это название выводится в качестве имени метапеременной в шаблонах конструктора коммуникаций.
2) Идентификатор – обязательное поле, которое используется в API-запросах, его написание должно точно совпадать с тем, как оно прописано в интеграции. Идентификатор метапеременной по событию должен быть уникальным.
3) Описание – информационное поле, в котором пользователь может для своего удобства указать краткое описание событийной метапеременной.
4) Значение по умолчанию (используется при тестировании) – значение метапеременной, которое подставляется в текст коммуникации при тестовой отправки рассылки. Нужно для удобства просмотра отображения текста, так как при тестировании в системе нет событий, следовательно, нет параметров из событий, которые можно было бы подставить в коммуникацию.
После заполнения полей нужно нажать кнопку “Сохранить”. Произведенные с метапеременной изменения фиксируются на вкладке “Аудит”.

Все созданные метапеременные по событиям хранятся в списке подраздела “Метапеременные для событий” раздела “Настройки” Manzana Campaign. Для удобства просмотра списка доступна кнопка сворачивания и разворачивания боковой панели с перечнем подразделов.

В списке событийных метапеременных можно посмотреть следующие данные:
- Имя – название, присвоенное пользователем при создание метапеременной по событию.
- Идентификатор – идентификатор событийной метапеременной.
- Дата создания – когда была создана данная метапеременная по событию.
- Дата изменения – дата последнего изменения метапеременной по событию.
- Автор – кто создал событийную метапеременную.
Доступна сортировка по возрастанию и убыванию для всех столбцов списка. Также доступен поиск по названию событийных метапеременных, он расположен под кнопкой “Создать” в правой части рабочей области.

Использование метапеременных в коммуникациях
Метапеременные можно использовать в текстовой части сообщения. Они располагаются в разделе “Персонализация” шаблонов коммуникаций. Общие и событийные метапеременные находятся в верхней части списка переменных этого раздела. Параметризуемые метапеременные вынесены в отдельный подраздел.

Доступен функционал поиска по названию метапеременных в списке раздела “Персонализация”.

Чтобы добавить метапеременную в коммуникацию, нужно установить курсор в нужное место текстового поля в шаблоне коммуникации и затем кликнуть по метаперенной в разделе “Персонализация”. Метапеременная будет добавлена в текст. При добавлении в сообщение параметризуемых метапеременных под текстовым полем шаблона появляется разделе “Выбранные параметризуемые переменные”, в котором эти переменные отдельно вынесены для последующей настройки.
Для параметризуемых метапеременных нужно дополнительно настроить условия. Общие метапеременные в настройках не нуждаются.
Чтобы настроить условия внутри параметризуемой метапеременной, необходимо найти нужную в разделе “Выбранные параметризуемые переменные” и нажать на шестеренку. Откроется окно настройки дополнительных условий в соответствии с выбранной метапеременной. Набор условий персонализирован для каждой параметризуемой метапеременной. В открывшемся окне необходимо кликнуть на кнопку «Добавить условие», после чего выбрать необходимые значения по аналогии с работой в функционале шага «Портрет участника» при создании сегмента.
Для удобства пользователей параметризуемые метапеременные, по которым не добавлены условия настройки, обозначены светло-красным фоном в тексте коммуникации. После настройки цвет фона меняется на зеленый.
Важно: добавленные в сообщение параметризуемые метапеременные отображаются и настраиваются в разделе "Выбранные параметризуемые метапеременные" для всех каналов коммуникаций, где доступно добавление метапеременных, кроме канала Email. В редакторе Email-сообщений параметризуемая метапеременная после добавления отображается в текстовом блоке письма. Её настройка производится путем нажатия на название непосредственно в тексте коммуникации.

Посмотреть настройки параметризуемой метапеременной можно даже в запущенной коммуникации. Для этого нужно перейти в редактор шаблона нужного шага и кликнуть по шестеренке. Обратите внимание, что для запущенной акции можно только посмотреть настройку, ее изменение недоступно.
Особенности использования метапеременных из универсального импорта
Загруженные универсальным импортом значения в столбцах со 2 по 16 можно использовать в рассылке в качестве метапеременной.
В шаблонах в разделе «Параметризуемые метапеременные» представлено 15 метапеременных с названием «Метапеременная idX», где Х – это номер столбца из файла импорта (название полностью совпадает с названием столбца).

Чтобы использовать метатепеременную, необходимо добавить ее в шаблон сообщения, как и любую другую метапеременную, но в параметрах обязательно нужно указать название маркетингового списка, из которого необходимо отобразить значение.
Пример использования метапеременных из универсального импорта можно посмотреть по ссылке.
Особенности использования событийных метапеременных
Событийные метапеременные используются только в акциях по событию. Для работы такой акции необходимо настроить передачу события со стороны сайта, мобильного приложения или какой-либо другой внешней системы.
Особенность событийной метапеременной заключается в том, что она может использовать для подстановки в коммуникацию только те данные, которые были получены в параметре события для конкретного контакта.
Для использования событийной метапеременной в тексте коммуникации необходимо:
- В разделе “События” Manzana Campaign создать событие. При его поступлении в систему впоследствии будет срабатывать акция по событию. Подробнее о функционале создания событий можно прочитать в статье.
- В разделе “Настройки” - “Метапеременные для событий” Manzana Campaign нужно создать метапеременные, которые будут использоваться в сообщениях.
Обратите внимание, что если планируется выводить в коммуникацию несколько параметров из события, то для каждого из них необходимо создать отдельную метапеременную. Например, если нужно отправить SMS с подтверждением оформленного заказа, где будет содержаться номер сделанного заказа и ожидаемая дата доставки, то эти данные будут подставляться в текст сообщения с помощью 2 метапременных (соответственно, “Номер заказа” и “Дата доставки”). Их предварительно нужно создать в Campaign. Идентификаторы, присвоенные этим переменным при создании, должны совпадать с названиями полей, передаваемых в событие.
- Настроить передачу события, созданного в п.1, из внешней системы в Manzana Campaign.
- Создать и настроить акцию по событию. На шаге “События” необходимо выбрать событие, при поступлении которого будет отправляться коммуникация. В шаблоне коммуникации в разделе “Персонализация” можно найти по названию созданные ранее событийные метапеременные и добавить их в нужные части сообщения.
Пример использования событийных метапеременных в акции можно посмотреть в статье.
Особенности генерации штрихкодов для email в Manzana Campaign
В Manzana Campaign есть возможность добавлять в email-сообщения сгенерированные персональные штрихкоды. Формирование штрихкодов происходит с помощью параметризуемых метапеременных. Посмотреть видео по этому функционалу можно по ссылке.
Источниками формирования штрихкодов для email могут служить:
- купоны, выпущенные в Manzana Loyalty Online,
- данные из универсального импорта Manzana Campaign.
Доступно преобразование данных в следующие форматы штрихкодов:
1) EAN 13 (англ. European Article Number, EAN – европейский номер товара) – европейский стандарт штрихкода, используемый для идентификации товаров при сканировании на POS-терминале. 
Manzana Campaign может сформировать штрихкод в формате EAN 13 для подстановки в email, только если исходные данные для штрихкода соответствуют следующим условиям:
- Используются только арабские цифры.
- Может содержать 7 или 12 цифр (без контрольного символа, который обычно использует в штрихкодах формата EAN 13).
2) CODE 128 – линейный штрихкод, используемый для кодирования буквенно-цифровой информации.

Сгенерировать штрихкод в формате CODE 128 с помощью Manzana Campaign можно, если соблюдены следующие требования к исходным данным:
- Используются арабские цифры, строчные и заглавные буквы латинского алфавита, спецсимволы ! " # $ % ^ & * ( ) - = | \ / : ; , ' . " ~ + - _ * { } :
- Может содержать от 1 до 80 символов.
3) PDF 417 (англ. Portable Data File — переносимый файл данных) – двумерный штрихкод, поддерживающий кодирование до 2710 знаков.

Для формирования штрихкода в формате PDF 417 нет требований к исходным данным, можно использовать любые символы.
4) QR (англ. Quick Response code — «код быстрого отклика») – тип матричных или двумерных штрихкодов. Этот формат позволяет кодировать широкий спектр данных: текст, URL ссылку, номер телефона, email, переход в telegram-канал и т.д.

Для генерации штрихкода в формате QR нет требований к исходным данным.
Метапеременные для генерации штрихкодов
Для формирования штрихкодов и выведения их в шаблон email-сообщения в Campaign используются следующие параметризуемые метапеременные:
- QR (купон),
- QR (импорт),
- ШК EAN 13 (купон),
- ШК EAN 13 (импорт),
- ШК CODE 128 (купон),
- ШК CODE 128 (импорт),
- ШК PDF 417 (купон),
- ШК PDF 417 (импорт).
В названии каждой метапеременной в скобках указан источник, который она использует для формирования штрихкода.
Важно: Все параметризуемые метапепеременные, источником для которых служит файл универсального импорта, используют для формирования персонального штрихкода данные из 16-го столбца файла с наименованием Id15. Необходимо это учитывать при создании файла импорта.
Каждая метапеременная обеспечивает корректную генерацию соответствующего штрихкода в зависимости от выбранного типа и источника данных. Это позволяет эффективно адаптировать коммуникацию с контактами, использовать в рассылке штрихкоды, которые удобно показывать на кассе.
Параметризуемые метапеременные для формирования штрихкодов добавляются в текст email-сообщения так же, как любые другие метапеременные. После добавления в тексте отображается демонстрационный штрихкод в соответствующем формате, который позволяет увидеть отображение в письме.
При нажатии на шестеренку в правом верхнем углу метапеременной открывается окно настройки условий, где можно задать фильтры для однозначного определения источника штрихкода.

Редактировать отображение штрихкода в шаблоне письма можно в левой панели.

Описание метапеременных для формирования штрихкодов с настройками и примерами их использования можно посмотреть в статье.
Метапеременные для подстановки товаров в письмо
Разновидностью параметризуемых являются табличные метапеременные. Они используются только в email-рассылках и служат для подстановки характеристик товаров в верстку письма. Чаще всего при размещении товаров в email используются такие характеристики, как: название, фото, актуальная цена, цена до скидки и т.д. Пример письма с блоком товаров на рисунке ниже.

Табличные метапеременные используются, когда необходимо отобразить в письме в виде блока (таблицы) несколько товаров, принадлежащих какому-либо списку контакта. Например, можно отправить:
- последние просмотренные при посещении сайта продукты (сценарий “Брошенный просмотр”),
- персонально подобранные товары, которые заинтересуют пользователя,
- товары из избранного, на которые снизилась цена и т.д.
К табличным метапеременным в конструкторе писем Manzana Campaign относятся:
- Персональные предложения
- Товарный список
Подробнее об использовании этих метапеременных можно прочитать в статье.