Подстановка данных с помощью SRT-блоков

В системе eSputnik есть возможность автоматически создавать контент для писем с использованием внешних источников данных (откуда будут передаваться данные) и уже настроенных и сохраненных модулей в библиотеку (которые определяют дизайн элемента в письме).

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

SRT определяет внешний вид и правила, по которым будут подставляться данные в полосу. Конструктор разделен на 3 секции:

• Start section (Начальная) – здесь вы можете определить, какие модули должны быть размещены в самом начале автоматически сгенерированной области.

• Repeatable section (Повторяющаяся) – здесь вы можете установить правило, какие модули следует использовать для каждого цикла (круга). Это очень полезно, если вы хотите чередовать разные модули или использовать некоторые специфические модули в отдельных циклах.

• Tail section (Хвостовая секция) – это место, где вы можете установить правило для отображения определенного модуля в случае, если в вашем источнике данных недостаточно элементов (товаров) для завершения всего круга из повторяемой области.

Теория. Базовые настройки SRT

Прежде чем приступать к работе, необходимо:

• подключить один из источников данных (Google Sheets, рекомендации);

• настроить smart-контейнеры для выбранного источника и сохранить в библиотеку модулей.

Затем можно приступать к подготовке внешнего вида блоков для подстановки.

Подготовка письма и настройка SRT

Добавьте полосу в письмо. Кликните на фон вокруг письма в редакторе и нажмите на “+”.

Перейдите в раздел “Данные” → Dynamic:

Заполните такие поля:

• Название элемента. 

• Источник данных. Если у вас ещё ни один источник не подключен, воспользуйтесь нашей инструкцией.

• Выберите из выпадающего списка, какое действие выполнить, если источник данных будет пуст:

  • скрывать элемент,

  • показывать элемент,

  • не генерировать письмо. 

Кликните дважды на полосу, чтобы указать значения для подстановки:

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

1. Стартовая секция
   Какие модули должны размещаться в самом начале динамического элемента.

2. Повторяющаяся секция
   Какие модули следует использовать в цикле и правила для подстановки блоков.

3. Замыкающая секция
   Какой модуль/модули следует использовать в самом конце динамического элемента.

Заполнение всех секций необязательно. Секции №1 и №3 используются для статичных элементов, то есть они будут изображаться в том виде, как вы их зададите. Их можно не заполнять. 

Рассмотрим вторую секцию, которая предназначена для заполнения повторяющимися элементами.

Настройка SRT (Repeatable section)

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

• модуль с тремя товарами в строке;

• модуль с двумя товарами в строке;

• модуль с одним товаром в строке (если останется один товар в источнике).

Что примет такой вид:

В момент отправки письма в указанные блоки будут подставляться товары из источника данных и чередоваться 3+2+3+2. Блоки будут повторяться, пока товары не закончатся в файле. Одиночная структура отобразится только если останется в файле один последний товар.

Вид структуры можно выбрать из ваших сохраненных модулей во вкладке “Мои модули” или из вкладки “Общие”:

Перетащите её в письмо – отобразится пустая структура, которую нужно заполнить смарт-контейнерами.

Можно сразу переходить к тестированию или задать специфические правила для показа модулей в письмах. 

Задаются правила отображения всей структуре

или каждому контейнеру отдельно.

Приведем пример, какой вариант настройки выбрать:

1. Настройки структур. Нужно, чтобы отображались по два товара в структуре. Но в фиде может быть нечетное количество товаров.

Тогда добавляем две структуры: одну на 2 товара и ниже – на 1 товар. Для структуры на 1 товар добавляем правило "Применять, если в источнике данных осталось заданное кол-во записей" и пишем значение 1. Если в фиде 4 товара, они отобразятся 2+2. Если в фиде 5 товаров, они отобразятся последовательно 2+2+1.

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

• один блок – новая цена + перечеркнутая старая цена;

• второй блок – только текущая цена.

Добавляем правило: если у товара есть поле oldPrice, показывать один контейнер, если нет – другой.

Настройка структуры

Чтобы задать настройки, выделите нужный блок. Слева откроется меню, где можно:

• Оставить текущие – внешний вид блока будет соответствовать добавленному. Используйте этот вариант, когда необходимы статичные данные. Например, баннер или описание: “Вы просматривали эти товары”, “Для вас будут интересны”.

• Применить другие – отобразится только пустая структура, которую нужно заполнить смарт-блоками для подстановки данных.

Для последнего варианта после добавления смарт-блоков станут доступны “Колонки”, где можно задавать правила для каждой горизонтальной или вертикальной колонки отдельно.

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

Далее можно добавлять правила, которые одинаковы и для блоков, и для структур.

Перейти к описанию правил >>

Настройка контейнера

Обратите внимание, что внешний вид контейнеров в самом SRT-конструкторе менять нельзя. Редактирование можно выполнить в параллельной вкладке или вернуться в письмо. После внесения изменений нужно обновить блок в библиотеке.

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

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

Если вы выберете “Нет”, то информация останется без изменений, блок будет статичным.

Например, для левого блока выбрано "Нет" и он остается статичным, а для правого оставлено “Да” и в нем меняются карточки.

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

Правила для применения в блоках и структурах

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

Как это работает?

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

1. Прежде всего создаем альтернативный контейнер, для которого появится пометка “Или”:

2. Задаем настройки нижнему контейнеру, беря из источников данных нужную переменную. В нашем случае – это название столбца oldPrice:

3. Прописываем в поле переменную точно так, как указано в таблице.

Таким образом, у товаров со старой ценой она отобразится в карточке.

Вариант 2. Применять, если в источнике данных осталось заданное количество записей

Как это работает?

Например, в источнике используется нечетное количество товаров.

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

Вариант 3. Применять только к заданному циклу

Как это работает?

Например, у нас есть 12 товаров и нужно после 6 товаров показывать кнопку СТА.

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

Получается, что первые два цикла содержат по 3 товара. После их подстановки добавится кнопка СТА, затем опять товары.

Вариант 4. Применять к циклам, значение которых кратно заданному числу

Как это работает?

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

Например, у нас есть 12 товаров и нужно после каждых 6 товаров показывать кнопку СТА.

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

Цикл #1 и #2 содержат по 3 товара. После их подстановки, в цикл #3 добавится кнопка СТА, затем опять два цикла по 3 товара – и опять отобразится кнопка.

Вариант 5. Применять, начиная с заданного цикла

Как это работает?

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

Например, нужно, чтобы сначала была верстка блоков по 3 товара в ряд, затем сменилась на 2 товара.

Мы указываем для блока с 2 товарами “5”, что отобразит этот тип верстки только с 5-го цикла.

Вариант 6. Применять до заданного цикла

Как это работает?

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

Например, нужно, чтобы сначала была верстка блоков по 3 товара в ряд, затем сменилась на 2 товара.

Мы указываем для блока с 3 товарами “5”, что отобразит этот тип верстки только до 5-го цикла. 

Начиная с 6-го цикла, оформление сменится на два товара в ряд.

Произвольный код

Генерируется, когда вы вносите изменения через SRT-конструктор, или можно прописать его самостоятельно. Например, если вам нужно скопировать код из другого письма или просмотреть структуру полосы.

Часть 2. Пример создания письма SRT

Прежде чем создать письмо, подключите хотя бы один источник данных в личном кабинете (Настройки → Источники данных).

Создание блоков для письма. Подготовительный этап

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

1. Создаем и сохраняем в библиотеку блоков структуру "Хедер".

2. Создаем пустую структуру с двумя контейнерами и добавляем ее в библиотеку модулей:

3. Отдельно создаем смарт-блок в структуре на два контейнера и сохраняем его в библиотеку. В нашем случае источник данных – Гугл-таблица. Названия полей в таблице – это и есть наши переменные для подстановки.

Можно использовать готовые смарт-блоки из библиотеки: Модули → Общие → Карточки товаров.

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

Обратите внимание, что для подстановки в SRT нужны именно контейнеры. Поэтому можете сохранить отдельно блоки, отдельно – структуру, чтобы упростить заполнение SRT-полосы.

4. Создаем смарт-блок с перечеркнутой старой ценой в структуре на два контейнера и сохраняем его в библиотеку.

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

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

Настройка SRT в письме

1. Заходим в настройки полосы и кликаем Dynamic. Затем даем название элемента, выбираем источник данных, который указан в smart-блоках, и что делать, если источник пуст.

2. По клику на  SRT-полосу открываем конструктор:

Опционально в стартовую секцию добавляем из модулей структуру "Хедер", кликаем на нее и слева выбираем "Оставить текущие":

3. В повторяющуюся секцию добавляем из модулей пустую структуру:

4. Перетягиваем в нее смарт-блоки со старой ценой.

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

5. Выбираем каждый контейнер со старой ценой и добавляем правило "Применять, если заданное поле присутствует в источнике данных". В этом случае, если есть oldPrice, чтобы клиент увидел перечеркнутую старую цену.

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

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

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

Как будет выглядеть письмо

• в SRT-конструкторе;

• в редакторе;

• после отправки.

Отправка тестового сообщения

Чтобы проверить подстановку данных, используйте отправку через кнопку "Test" в редакторе.

Либо отправьте тест в списке сообщений через пункт “Создать рассылку”,

выбрав нужный email во вкладке “Контакты”.

Читайте также как настроить письмо с рекомендациями в аккаунте eSputnik.