Персонализация (метапеременные)

Редактировал(а) Валентина Чайко 2026/01/14 08:31

Метапеременные в Campaign

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

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

Работа с метапеременными производится при настройке шаблона коммуникации (или из самого шаблона, или на шаге коммуникации).

Например, есть возможность использовать метапеременную [%Имя%] при составлении шаблона сообщения для того, чтобы обратиться к каждому клиенту персонально, если значение его имени записано в CRM.

1730898843127-961.png

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

Важно:

1) В качестве метапеременных можно использовать только те данные, которые есть в системе.

2) При использовании метапеременных подсчет символов в системе производится исходя из количества символов, соответствующих выбранной метапеременной. Рекомендуется учитывать данный момент при составлении сообщения, особенно в канале SMS. Так, например, метапеременная «Имя» рассчитывается системой как 7 символов, хотя значения из CRM могут варьироваться в зависимости от контактных данных пользователя. При организации отправки система автоматически меняет значение метапеременной на значение из CRM, в процессе данной подмены «Имя» превращается в конкретное обращение к клиенту – Ирина (5 символов), Алевтина (8 символов). Метапеременная «Количество сгораемых бонусов» рассчитываемая системой как 34 символа, будет заменена на конкретное число бонусов – 100 (3 символа).

Виды метапеременных

Общие – стандартные метапеременные, которые несут в себе одно конкретное значение из CRM. Не требуют дополнительной настройки и сразу готовы к использованию.

Параметризуемые – метапеременные, в которых можно указать дополнительные условия отбора. Например, вам нужно подставить в коммуникацию купоны клиента, но не все, а только определенного выпуска и с истекающей датой сгорания. Тогда можно использовать параметризуемую метапеременную, внутри которой задаются необходимые условия. Параметризуемые переменные обозначаются значком «шестеренка» https://campaign.manzanagroup.ru/user_documentation/pictures/metavariables11.jpgData URI image в конце их наименования и требуют дополнительной настройки условий.

Список и описание общих и параметризуемых метапеременных можно найти в документе по ссылке.

Событийные – метапеременные, которые позволяют подставлять в коммуникацию параметры приходящего события в качестве динамического контента. Используются для быстрого информирования клиента об изменениях, которые поступают в Manzana Campaign в событиях, например:

  • изменении статуса заказа,
  • подтверждение записи на услугу,
  • информирование о начислении баллов за совершенную покупку,
  • повышении уровня контакта в программе лояльности и т.д.

Создание метапеременных

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

Событийные метапеременные пользователи Manzana Campaign создают самостоятельно. Для этого нужно перейти в раздел “Настройки”, подраздел “Метапеременные для событий” и нажать кнопку “Создать”.

1750094149686-142.png

В открывшемся окне редактора необходимо задать следующие характеристики создаваемого события:

1) Название – это название метапеременной. Оно отображается в шапке страницы, используется при поиске в списке событийных метапеременной в разделе “Метапеременные для событий”. Также это название выводится в качестве имени метапеременной в шаблонах конструктора коммуникаций.

2) Идентификатор – обязательное поле,  которое используется в API-запросах, его написание должно точно совпадать с тем, как оно прописано в интеграции.  Идентификатор метапеременной по событию должен быть уникальным.

3) Описание – информационное поле, в котором пользователь может для своего удобства указать краткое описание событийной метапеременной.

4) Значение по умолчанию (используется при тестировании) – значение метапеременной, которое подставляется в текст коммуникации при тестовой отправки рассылки. Нужно для удобства просмотра отображения текста, так как при тестировании в системе нет событий, следовательно, нет параметров из событий, которые можно было бы подставить в коммуникацию.

После заполнения полей нужно нажать кнопку “Сохранить”. Произведенные с метапеременной изменения фиксируются на вкладке “Аудит”.

1750094292337-317.png

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

1750094329266-569.png

В списке событийных метапеременных можно посмотреть следующие данные:

  • Имя – название, присвоенное пользователем при создание метапеременной по событию.
  • Идентификатор – идентификатор событийной метапеременной.
  • Дата создания – когда была создана данная метапеременная по событию.
  • Дата изменения – дата последнего изменения метапеременной по событию.
  • Автор – кто создал событийную метапеременную.

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

1750094450838-456.png

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

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

1750094520916-850.png

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

1750094560934-396.png

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

https://lh7-rt.googleusercontent.com/docsz/AD_4nXf27CU6dr3Lh4xb7bDX-rXSKTnOb6Yr9QiI1e2WVhRePDOcnHCuF7rv-d0e5vQW7Ja4UZql4PIGh6BCrdREXa7pfv8mjnRAmu5XX4aBEiDkTaYNYrsKOy42MMAdRUe5WeRv0sYSng?key=rghqGHl-Me01mD9bQArqxQ

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

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

https://lh7-rt.googleusercontent.com/docsz/AD_4nXfqFN8u-vyYaEcplMWd3EebT5Os2DQhyK0-a05d2yICYG-GWCmuIYaJSNiZKC5o15UrUyYoaCymsZZ30mghDcC80zzCeqJ5kxFmD8rkZudsorsKIdrJ1gBtLz28JHK-X00xJzxCKg?key=rghqGHl-Me01mD9bQArqxQ

https://lh7-rt.googleusercontent.com/docsz/AD_4nXfEcMlhERkh6Ou7ou3FwAOIkhMO2KuJ1Y7lm-cf7MunbRHPn__87K5RXZmkfyyJ_WREKmOVpOzV8p-xlBbOp9F58o3Yqw7JIGUrQ6qaAOKcGg38CHomfKNMMNCvXa685UKO3xYH?key=rghqGHl-Me01mD9bQArqxQ

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

https://lh7-rt.googleusercontent.com/docsz/AD_4nXeJUekVXs9Ze1BIDlEYriYCdFL5zsST9-4lSN3_iR35RwgfogpzMXIQSW5BltmZDcp5Nbb4kTt5vRS3Y8RZ_THnqB4s9m5g6MTxY-HoVczHJTN_6lPGSDEOrk0QR3rBGo0jlAg2VA?key=rghqGHl-Me01mD9bQArqxQ

Важно: добавленные в сообщение параметризуемые метапеременные отображаются и настраиваются в разделе "Выбранные параметризуемые метапеременные" для всех каналов коммуникаций, где доступно добавление метапеременных, кроме канала Email. В редакторе Email-сообщений параметризуемая метапеременная после добавления отображается в текстовом блоке письма. Её настройка производится путем нажатия на название непосредственно в тексте коммуникации.

1752161528611-158.png

Посмотреть настройки параметризуемой метапеременной можно даже в запущенной коммуникации. Для этого нужно перейти в редактор шаблона нужного шага и кликнуть по шестеренке. Обратите внимание, что для запущенной акции можно только посмотреть настройку, ее изменение недоступно.

Особенности использования метапеременных из универсального импорта

Загруженные универсальным импортом значения в столбцах со 2 по 16 можно использовать в рассылке в качестве метапеременной.

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

1716729165600-670.png

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

Пример использования метапеременных из универсального импорта можно посмотреть по ссылке.

Особенности использования событийных метапеременных

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

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

Для использования событийной метапеременной в тексте коммуникации необходимо:

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

Обратите внимание, что если планируется выводить в коммуникацию несколько параметров из события, то для каждого из них необходимо создать отдельную метапеременную. Например, если нужно отправить SMS с подтверждением оформленного заказа, где будет содержаться номер сделанного заказа и ожидаемая дата доставки, то эти данные будут подставляться в текст сообщения с помощью 2 метапременных (соответственно, “Номер заказа” и “Дата доставки”). Их предварительно нужно создать в Campaign. Идентификаторы, присвоенные этим переменным при создании, должны совпадать с названиями полей, передаваемых в событие.

  1. Настроить передачу события, созданного в п.1, из внешней системы в Manzana Campaign.
  2. Создать и настроить акцию по событию. На шаге “События” необходимо выбрать событие, при поступлении которого будет отправляться коммуникация. В шаблоне коммуникации в разделе “Персонализация” можно найти по названию созданные ранее событийные метапеременные и добавить их в нужные части сообщения.

Пример использования событийных метапеременных в акции можно посмотреть в статье.

Особенности генерации штрихкодов для email в Manzana Campaign

В Manzana Campaign есть возможность добавлять в email-сообщения сгенерированные персональные штрихкоды. Формирование штрихкодов происходит с помощью параметризуемых метапеременных. Посмотреть видео по этому функционалу можно по ссылке.

Источниками формирования штрихкодов для email могут служить:

  • купоны, выпущенные в Manzana Loyalty Online,
  • данные из универсального импорта Manzana Campaign.

Доступно преобразование данных в следующие форматы штрихкодов:

1) EAN 13 (англ. European Article Number, EAN – европейский номер товара) – европейский стандарт штрихкода, используемый для идентификации товаров при сканировании на POS-терминале. 
1754984782820-419.png

Manzana Campaign может сформировать штрихкод в формате EAN 13 для подстановки в email, только если исходные данные для штрихкода соответствуют следующим условиям:

  • Используются только арабские цифры. 
  • Может содержать 7 или 12 цифр (без контрольного символа, который обычно использует в штрихкодах формата EAN 13).

2) CODE 128  линейный штрихкод, используемый для кодирования буквенно-цифровой информации.

1754984856461-959.png

Сгенерировать штрихкод в формате CODE 128 с помощью Manzana Campaign можно, если соблюдены следующие требования к исходным данным:

  • Используются арабские цифры, строчные и заглавные буквы латинского алфавита, спецсимволы ! " # $ % ^ & * ( ) - = | \ / : ; , ' . " ~ + - _ * { } :
  • Может содержать от 1 до 80 символов.

3) PDF 417 (англ. Portable Data File — переносимый файл данных двумерный штрихкод, поддерживающий кодирование до 2710 знаков.

1754984891004-860.png

Для формирования штрихкода в формате PDF 417 нет требований к исходным данным, можно использовать любые символы.

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

1754984922063-222.png

Для генерации штрихкода в формате QR нет требований к исходным данным.

Метапеременные для генерации штрихкодов

Для формирования штрихкодов и выведения их в шаблон email-сообщения в Campaign используются следующие параметризуемые метапеременные:

  • QR (купон), 
  • QR (импорт), 
  • ШК EAN 13 (купон), 
  • ШК EAN 13 (импорт), 
  • ШК CODE 128 (купон), 
  • ШК CODE 128 (импорт), 
  • ШК PDF 417 (купон), 
  • ШК PDF 417 (импорт).

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

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

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

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

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

1754985030195-937.png

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

1754985055420-760.png

Описание метапеременных для формирования штрихкодов с настройками и примерами их использования можно посмотреть в статье.

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

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

1765966147408-266.png

Табличные метапеременные используются, когда необходимо отобразить в письме в виде блока (таблицы) несколько товаров, принадлежащих какому-либо списку контакта. Например, можно отправить:

  • последние просмотренные при посещении сайта продукты (сценарий “Брошенный просмотр”),
  • персонально подобранные товары, которые заинтересуют пользователя,
  • товары из избранного, на которые снизилась цена и т.д.

К табличным метапеременным в конструкторе писем Manzana Campaign относятся:

  • Персональные предложения
  • Товарный список

Подробнее об использовании этих метапеременных можно прочитать в статье.