Инструкция по переносу верстки в email шаблон Manzana Campaign для коммуникации с товарами ПП

Редактировал(а) Валентина Чайко 2025/01/02 20:02

Перенос верстки в email шаблон Manzana Campaign для коммуникации с товарами ПП

1. На рис.1 представлен пример письма, который нужно перенести в конструктор Campaign, где:

  • 1 и 2 - статические блоки шаблона, которые не содержат метапеременную “Персональные предложения” (ПП)
  • 3 - динамический блок с версткой для метапеременной “Персональные предложения”

Рис. 1 - Пример шаблона, верстку которого необходимо перенести в Campaign.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXeBkacxNV_mobVj5_wfnqzaLYGG3higgwdvYd_NhDu5pjSQY8s2AZizkYKF6n4yYf3Fr1FS_VHE156nKySfzN5w81OdUaClrjBDJltl3_8DBgJOaVJj8PWokoFEK9WDfQC4sjajObpNoNW81TqsYnnwSlbD?key=YGy1QkpIcJ80Rppp_PP5wAk2https://lh7-rt.googleusercontent.com/docsz/AD_4nXdzMFMskQlqAKDayV2ClmYy9Dqkrm8IzO2WzGCLdD76yjR6jHMzIEd-xGMTZ2J-1hXYyxx-l2jTwjrRcqC4lYlrWsJpAlMNVvvCi9Q6pobyVJ2szu_fFC5wvioHw56uukyChWfljgLMwPED0z4tv62nsrw?key=YGy1QkpIcJ80Rppp_PP5wAk2

2. Нужно открыть шаблон письма в любом HTML редакторе. Верстка статических блоков 1 и 2 не изменяется. А код для динамического блока 3 необходимо скопировать и сохранить в отдельном файле. В пп.7-9 будет производиться его доработка для появления в письме товаров из списка ПП в нужном виде. Но сначала необходимо добавить в письмо соответствующую метатепеременную. Для удобства вместо кода из блока 3, нужно поставить отметку “Здесь будет метапеременная”. 

Рис. 2 - В верстке письма отмечено место для метапеременной.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXcaX-6z-F5ghTGPBsUeK6ekB6xoZERoS9snp2-dgrJchaIrFdRn8sBUZRG4LK3Wn4FOa8mDFDErdUTkBRTvqZvLegfWCkF8nChkgkzv__usxOhh8vn_oESnjk0YZaxyycXHVH_v?key=YGy1QkpIcJ80Rppp_PP5wAk2

3. Нужно создать пустой шаблон Email.

Рис. 3 - Новый шаблон email, выделена кнопка “Редактор HTML”

https://lh7-rt.googleusercontent.com/docsz/AD_4nXeAlmtGjRgw19Y7Qjjerl6eM3uZqg_vi97Y5NQxdGw0M9Gnas0Ybj8P4Q0XcAGumO8bduKZYo1bW_OExB3LjIoV6D4fX5wnCDdOA_Xcc6VW7MylGcYAF-9e6C5wH8QLD5wbhkjiiPDAYiUDuAXJxG9SqFbZ?key=YGy1QkpIcJ80Rppp_PP5wAk2

4. В редакторе HTML нужно вставить полученную в п.2 верстку email с двумя статическими блоками и одним выделенным под метапеременную. В конструкторе можно будет увидеть письмо с отметкой “Здесь будет метапеременная”. 

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

Рис. 4.1 - Отображение письма, для которого картинки добавлены с помощью ссылок.

1731586164660-453.png

Рис. 4.2 - Отображение письма без ссылок на картинки.

1731586548171-901.png

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

Рис. 5 - Окно загрузки картинки в конструкторе email.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXfSdhvnDaK_dO3N9tCtgKs1Ruyn7bZi9lg7Ebe1EXfvPu8yLS2_KBXjInO0HtJ5zP4zpw564Ze2gv5NEmgICIu-eTyRol9O5VDrh9wlew3b3blsUw4rfYUWO_17zvSCYd3trKZy6QBgSO326E2-mDEq8XOP?key=YGy1QkpIcJ80Rppp_PP5wAk2

6. Для добавления метапеременной ПП в блок нужно удалить надпись “Здесь будет метапеременная”, а затем кликнуть дважды на блоке письма, в котором она находилась. В появившихся настройках нужно выбрать “Персонализация”.

Рис. 6.1 - Выбор “Персонализации” в блоке, где была отметка “Здесь будет метапеременная”.

1731588358987-152.png

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

Рис. 6.2 - Выбор метапеременной “Персональные предложения”.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXexGhxkx9KfF2HsAuPaXJUXCPh245t1yKbErFqQb9UNVCZ-WS7vkxJ--NbjuBiRCBr08t1xB8zmg3Dm35g5MHYzvruAU6JueTn6XhEyFbQanTOsfjVKOZRTV7QPvDXYWX9Y1f45eyrVwJSW3HfEpJL8uec?key=YGy1QkpIcJ80Rppp_PP5wAk2

В пустом блоке появится ярлык метапеременной. После этого лучше сохранить шаблон письма. 

Важно сохранять письмо после каждого значимого изменения.

Рис. 6.3 - Ярлык метапеременной “Персональные предложения” в письме.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXdQKKL0uYdqQsKoVDzKVLWkN9GBboquOztDgmNJtJjrOlY5R3p7jzc3QHyTmnOH8uhhOd_BMJyTIGAfqKsgbYOGJDB2S4BU9hxXdEYY-Qw74MhlJJCjkvEBp43sz5t9ecEfbIyJBV0_SAfpeC2zk226BH0?key=YGy1QkpIcJ80Rppp_PP5wAk2

7. Далее необходимо настроить отображение товаров из списка ПП. Для этого нужно открыть в любом HTML редакторе файл с кодом динамического блока, который был сохранен отдельно в п.2. Здесь можно поменять те поля, которые планируется подставлять динамически на основе данных метапеременной “Персональные предложения”. 

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

  • [%Картинка_х_1%]
  • [%Название продукта_х_1%]
  • [%Размер скидки в процентах_х_1%]
  • [%Новая цена_х_1%]
  • [%Старая цена_х_1%]
  • [%Описание_х_1%] - помимо описания, в данном поле можно передавать ссылку для перехода на товар при клике по картинке.

Вместо “х” в код нужно подставить порядковый номер товара.

В рассматриваемом примере используются 3 характеристики:

  • [%Картинка_х_1%] - рис. 7 цифра 1
  • [%Название продукта_х_1%] - рис. 7 цифра 2
  • [%Размер скидки в процентах_х_1%] - рис. 7 цифра 3

Рис. 7 - Пример подстановки тегов внутри верстки для блока с метапеременной

https://lh7-rt.googleusercontent.com/docsz/AD_4nXdlFkMnxyjaMAoqeC3CusHhnpPdcXrFoIvVtVM8aL7H-e1D0Gm8oa3oAPPWbIDxsBXv8VtR9BFMioLMv2YEEFxQUQO0m5qA1UDcjs4i5m5u0wvN2UoLCMuinE6EKiAknxWZgOFvCA?key=YGy1QkpIcJ80Rppp_PP5wAk2

8. Сервисные метапеременные [%Отображать%] являются неотъемлемой составляющей любого HTML кода внутри параметризуемой метапеременной (в динамической части шаблона). Без них рассылка не будет отправлена.

Также в коде верстки письма может быть прописано определенное бизнес-пользователями количество мест, где разместятся товары из списка ПП. Например, необходимо отправить подборку из 10 товаров каждому клиенту интернет-магазина. При этом для конкретного пользователя количество рассчитанных Manzana Predictive Analytics персональных предложений может оказаться меньше 10, например, 4 товара. Чтобы оставшиеся в шаблоне зарезервированные 6 мест под товары не оказались пустыми в письме конкретного пользователя, нужно использовать функционал автоматического скрытия таких пустых мест под товары. Для этого важно правильно использовать сервисные метапеременные [%Отображать%].

Количество сервисных метапеременных [%Отображать%] должно быть равным количеству зарезервированных мест под товары списка ПП в шаблоне письма. Например, если планируется, что количество товаров для каждого из контактов будет варьироваться от 1 до 5, то динамическую часть шаблона создаем для 5 товаров (т.е. для максимально возможного количества). Каждую часть кода, отвечающую за отображение одного товара, помещаем между конструкцией “<!-- [%Отображать%]>” и “<!-- -->” следующим образом:

<!-- [%Отображать%]>
Место для 1-го товара в динамическом шаблоне
<!-- -->

<!-- [%Отображать%]>
Место для 2-го товара в динамическом шаблоне
<!-- -->

<!-- [%Отображать%]>
Место для 5-го товара в динамическом шаблоне
<!-- -->

Рис. 8.1 - Пример использования сервисных метапеременных [%Отображать%] в HTML коде для выведения товаров с характеристиками [%Картинка_х_1%], [%Новая цена_х_1%], [%Старая цена_х_1%], [%Размер скидки в процентах_х_1%] и  [%Название продукта_х_1%]

https://lh7-rt.googleusercontent.com/docsz/AD_4nXdMSLTay0IrXiz3TY6DScmigjtWTIsuPLc2CYtBehHE7RwwExN_ljZVVzZ5I5_qOMOyoqB-DH28j2lOynZKMZMr7p-Wo2FsTKUjZoWjns4Zm5awjFGFcW20rq51KHQbVRxCDJzd5w?key=YGy1QkpIcJ80Rppp_PP5wAk2

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

Для скрытия используется стандартный функционал комментирования HTML кода. Если после метапеременной [%Отображать%] в таких конструкциях мы подставить “--”, то можно увидеть, как браузер начнет отображать блок заключенный между ними.

Важно: В шаблоне, где планируется использовать функционал скрытия блоков, запрещается использовать тег <!-- --> внутри блоков, которые планируется скрывать.

Рис. 8.2 - Пример некорректного HTML кода с тегом <!-- -->

https://lh7-rt.googleusercontent.com/docsz/AD_4nXfrXeM-2Ui8xANWFe7zG2tB_ag1ESjhohxo6UBGXcASXpVfHziyfPBnhEelQhzDDHQO_STjZnTedNHoMxDN_KaJ6OUUbwl0hcsSpLN9aroUbONDArzm-aqSleOCi4zQLh05v5QV?key=YGy1QkpIcJ80Rppp_PP5wAk2

Мы рекомендуем использовать функционал автоматического скрытия мест под товары (товарных блоков) в коде HTML. Однако, если в шаблоне по какой-то причине не планируется скрывать блоки с товарами, то будет неважно точное расположение метапеременных [%Отображать%] внутри кода HTML. Но их наличие по-прежнему обязательно. В таком случае их для удобства лучше расположить в первых строках HTML документа. На рис.8.3 представлен фрагмент HTML кода для параметризуемой метапеременной с 5 блоками товаров.

Рис. 8.3 - Пример кода для параметризуемой метапеременной [%Отображать%] с 5 блоками товаров.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXcQ2ZBbF17LyzNycTXHLrejtRn0zKvnby4js2pBk_buu-AKAKzryCtnyy7NV8ae61bpKxta8Xh0I8TmZjv8-AdA3UTbY53WxdXGIPgsYvUMO2nxtHRSP-JYq5phxnNQeVZaLFWg?key=YGy1QkpIcJ80Rppp_PP5wAk2

9. Важно: Товары ПП по умолчанию выводятся в письмо в случайной последовательности, т.е. без учета приоритетов, присвоенных Manzana Predictive Analytics. 

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

<!--

[%Приоритет ПП_1_1%]

[%Приоритет ПП_2_1%] 

[%Приоритет ПП_3_1%]

[%Приоритет ПП_4_1%]

[%Приоритет ПП_5_1%]

[%Приоритет ПП_6_1%] 

-->

Метапеременные закомментированы, так как они являются сервисными и служат только для ранжирования товаров ПП. Количество метапеременных [%Приоритет ПП_n_1%] будет равно необходимому для вывода в письмо количеству товаров.

Рис. 9 - Добавление метапеременных в HTML для выведения товаров с учетом приоритетов.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXeTFDh49dr6tzWkB1xw-1p-TxWeKD1d0BcCHGVl2ejgV0j5hQBF4DAoAawKX-eNeuGt2yc8Jqag9rfD2ku27znzS-zGc95b3dSmquJ_vm88B0N55XiCrDW2osTgwuZMptkLgNY4-g?key=YGy1QkpIcJ80Rppp_PP5wAk2

10. После доработки файла с кодом динамического блока (пп.7-9) нужно подставить код в письмо. Для это необходимо вернуться в редактор email в Manzana Campaign и кликнуть по метапеременной “Персональные предложения” в соответствующем блоке.

Рис. 10.1 - Метапеременная “Персональные предложения” в шаблоне письма.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXcoNJvE0_dIumcyr_eBsV2GqjrBWgjPdh_I0yfTTQRuAY4BquUr01pJcZ90Da7S-6q-OzgngowYio3rjcZh1af3xT7JiTsLyyZtlftvQSG9xDsQJOyLrdObT91-JluZtqRaLTIVK-n4I8n1pacYabrYp1fS?key=YGy1QkpIcJ80Rppp_PP5wAk2

Откроется окно настройки метапеременной. В поле HTML окна настройки нужно вставить код верстки для динамического блока, подготовленный в пп.7-9, и нажать кнопку “Сохранить”.

Рис. 10.2 - Добавление кода динамического блока в окно настройки метапеременной.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXeaNlI-cMI7GGGrOn6SQx-0ijiA6Pz1hR11q9z2P7jUz2FgGWGT03X4rUCWloTRrZt47HiY2s7uc6L29mS_-cXOjnhixA0XFYTYQeT_SzpbSaxNf_eqx5-vWgbCZVpZuRQ5CBtNng?key=YGy1QkpIcJ80Rppp_PP5wAk2

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

Рис. 10.3 - Выбор фильтра метапеременной.

1732028453826-971.png

После этого в окне настройки метапеременной нужно нажать кнопку “Сохранить”.

В конструкторе шаблона также нужно нажать “Сохранить”.

Рис. 10.4 - Сохранение шаблона письма.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXcxh41PQnSsjOqLL54QSEMXRd5AJN_-tBHfP8W96mxYuI1JEKnOqt5qBdi8YnjHmLdDyif4HjrCZjhcCrpdl4C3cSzkJeyTK6At5CiGjQAtwr26tE5b5LqKpsc9pM-gZg?key=YGy1QkpIcJ80Rppp_PP5wAk2

Редактирование перенесенного в Manzana Campaign шаблона письма с ПП

Если после переноса HTML кода в шаблон Manzana Campaign требуется внести правки, то нужно выполнить следующие действия.

1. Зайти в шаблон письма.

2. Если необходимо изменить верстку статического блока, то нужно открыть HTML редактор в шаблоне.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXeAlmtGjRgw19Y7Qjjerl6eM3uZqg_vi97Y5NQxdGw0M9Gnas0Ybj8P4Q0XcAGumO8bduKZYo1bW_OExB3LjIoV6D4fX5wnCDdOA_Xcc6VW7MylGcYAF-9e6C5wH8QLD5wbhkjiiPDAYiUDuAXJxG9SqFbZ?key=YGy1QkpIcJ80Rppp_PP5wAk2

Вместо динамического блока в коде будет прописана метапеременная [%Персональные предложения_1%].

1731588695935-399.png
 

Можно отредактировать верстку статичного блока в редакторе Campaign или скопировать и перенести нужную часть кода в отдельный файл, отредактировать там и потом заменить ее в HTML редакторе Manzana Campaign.

2. Если требуется поменять динамический блок шаблона, нужно зайти в настройки метапеременной “Персональные предложения”, кликнув по нему.

1731588729143-197.png

Затем нужно скопировать верстку из поля HTML в открывшемся окне настройки метапеременной. Для этого нужно установить курсор в поле HTML и нажать Ctrl+A, чтобы выделить всю верстку. Потом нажать Ctrl+C для ее копирования.

https://lh7-rt.googleusercontent.com/docsz/AD_4nXfKDG-KfVXAgIIe7D3znoKhNTJVaWN52_6ZCIVPIcybFQCNRqQwGn0gJUhUoEk-Kie-5L-R0gk95PTQqtYkfklX91kC1wHXxjRVpzErr-FpGrLAG9FzWdCZuCSHrTb9pbePWCWk4w?key=YGy1QkpIcJ80Rppp_PP5wAk2

Полученный код можно вставить и отредактировать в любом редакторе, а после этого обновить верстку в поле HTML окна настройки метапеременной.

Таким образом, редактировать статические и динамические блоки необходимо отдельно.