Налаштування smart-контейнерів
Smart-контейнер — це елемент шаблону, що складається з базових блоків (зображення, текст, кнопка), контент яких автоматично підставляється зі сторінки товару на сайті або з публічного каналу — JSON-файлу, таблиці, RSS-стрічки або рекомендаційного джерела даних.
Використовуйте smart-контейнери, якщо потрібно швидко додати до листа картки товарів без ручного заповнення кожного елемента.
ВажливоЯкщо сайт використовує OG (Open Graph) теги, які надають структуровані дані про вміст веб-сторінки, це дозволяє eSputnik автоматично підставляти інформацію про товари в лист.
Коли дані з сайту не підтягуються або потрібно показати додаткові параметри товару, до існуючих карток параметри додаються вручну.
Вміст підтягується запитом з нашого боку до сторінки товару, тому якщо захист сайту блокує зовнішні запити, ні автоматичне підставлення, ні перевірка селектора нічого не повертають. Попросіть адміністраторів сайту додати до білого списку IP-адреси 18.193.171.62, 3.66.101.249 і 52.16.166.210.
У цій інструкції розглянемо, як перевірити, чи працює автозаповнення карток контенту і як внести вручну налаштування за необхідності.
Автозаповнення даних з сайту
При цьому способі потрібно лише скопіювати URL-адресу товару та вставити посилання в контейнер.
Додавання smart-контейнера до листа
-
Перейдіть до розділу Повідомлення → Повідомлення → Email.
-
Створіть новий лист або відкрийте існуючий.

- Відкрийте панель Структури і Модулі.

- Перейдіть на вкладку Мої модулі або Загальні модулі
- Виберіть категорію Картки товарів.

Для прикладу налаштуємо контейнери, що містять:
- Зображення товару,
- Назву,
- Ціну,
- Кнопку.
- Перетягніть модуль у лист.

Примітка
Якщо лист уже має налаштовані стилі, вони автоматично застосуються до доданого модуля.
Підстановка даних з сайту
- Відкрийте сторінку товару та скопіюйте URL.

- У налаштуваннях smart-контейнера відкрийте вкладку Дані й натисніть Підключити сторінку веб-сайту.
- Вставте URL у поле Посилання та натисніть Отримати.

Система автоматично підставить доступні дані.
ПриміткаТекст кнопки не змінюється автоматично. За потреби відредагуйте його вручну.

Повторіть дії з пп. 1–3 для кожного контейнера.

Зверніть увагуОкремої дії для видалення smart-контейнера немає. Щоб прибрати його вміст, виберіть рівень контейнера й скористайтеся очищенням вмісту — після цього контейнер залишиться в структурі порожнім.
Якщо плануєте використовувати модуль в інших розсилках — оновіть його або збережіть як новий.

Дані з публічного каналу
Публічний канал — це дані за публічним посиланням, наприклад список товарів:
- JSON — масив об'єктів; ключі об'єктів стають полями каналу;
- таблиця — посилання на CSV-файл, наприклад на експорт Google-таблиці у форматі CSV, доступної за посиланням. Кожен рядок — окремий запис, заголовки першого рядка — поля каналу;
- RSS — посилання на RSS-стрічку;
- рекомендаційне джерело даних — джерело даних з товарними рекомендаціями, створене в налаштуваннях облікового запису.
Контейнер заповнюється даними одного запису з каналу.

Підключення каналу
- У налаштуваннях smart-контейнера відкрийте вкладку Дані й у списку Джерело даних виберіть Публічний канал.

-
У списку Підключені джерела даних виберіть тип каналу:
- URL зовнішнього джерела — вставте посилання на канал;

- Джерела даних — у списку Оберіть джерело даних виберіть рекомендаційне джерело. Щоб знайти його за назвою, скористайтеся полем Пошук. Тут доступні лише рекомендаційні джерела.

- Натисніть іконку Отримати дані праворуч від списку.

Зіставлення полів і вибір запису
Після отримання даних відкривається вікно Зіставлення. У ньому перелічено змінні контейнера — по одній для кожного блоку, наприклад Name для текстового блоку.
- Для кожної змінної виберіть у списку поле з каналу, наприклад
title. Якщо назва поля схожа на назву змінної, редактор вибирає його сам — перевірте вибір. - Натисніть Застосувати та завантажити дані.

- У вікні Попередній перегляд даних виберіть запис: Елемент 1, Елемент 2 тощо. Щоб знайти потрібний запис, виберіть поле і введіть значення в рядок Пошук.
- Натисніть Застосувати.

Дані вибраного запису з'являться в контейнері.
Після підключення каналу на вкладці Дані доступні кнопки:
- Змінні — змінні контейнера. Для кожної задано блок (Застосувати дані до) і місце, куди підставляється значення (Вставити дані в): наприклад, текст абзацу або посилання кнопки (
href). Кнопка + Елемент додає змінну для ще одного блоку. - Зіставлення — змінити поле каналу, яке підставляється в змінну.
- Дані — вибрати інший запис із каналу.

Додавання додаткових параметрів
Цей спосіб надає більш гнучкий підхід для індивідуального налаштування змісту email, але потребує базових навичок роботи з HTML.
Використовуйте цей метод якщо потрібно додати нестандартні параметри товарів:
- розмір знижки,
- колір,
- артикул,
- країну походження,
- строк дії акції тощо.
Для налаштування додаткових параметрів потрібно виконати такі кроки:
- Додати блок до контейнера.
- Створити змінну.
- Налаштувати правила зіставлення CSS селектора.
Розглянемо приклад, коли потрібно додати до картки товару інформацію про додаткову знижку.
Додавання блоку
- Додайте до контейнера блок Текст.

- Виділіть блок та відкрийте редактор коду.
ПриміткаРедактор коду можна відкрити не лише для smart-контейнера, а й для будь-якого вибраного блока, контейнера, структури чи смуги (або для всього повідомлення, якщо нічого не вибрано), щоб редагувати його HTML напряму. Він містить вкладку HTML і окремі вкладки для стандартного та користувацького CSS, а також інструмент форматування, який робить код зручнішим для читання.
- Додайте HTML-атрибут, наприклад
class="Discount".

Створення змінних
- У налаштуваннях контейнера натисніть іконку Конфігурація.
- Натисніть +.
- Додайте новий Елемент і з випадного меню оберіть значення. В нашому прикладі це поле для показу додаткової знижки.
- Вкажіть:
- Ім’я змінної: Discount
- Значення змінної:
discount
- Збережіть конфігурацію.

Після цього в налаштуваннях контейнера з’явиться нове поле Знижка.

Правила зіставлення CSS селектора
- Відкрийте сторінку товару в браузері.
ПриміткаВ прикладі розглянуто базовий спосіб перевірки елементів веб-сторінки за допомогою DevTools в Google Chrome для Windows. Якщо ви користуєтеся іншими браузерами та операційними системами, зверніться до документації щодо використання DevTools та перевірки елементів.
- Відкрийте DevTools для перевірки елементу сторінки: натисніть на клавіатурі
Ctrl+Shift+ IабоF12. - Активуйте інструмент вибору елемента: натисніть
Ctrl+Shift+ Сабо кнопку з курсором у лівому верхньому куті на панелі DevTools.

- Клікніть на потрібний елемент (наприклад, розмір знижки).

- Скопіюйте CSS selector елемента.

- У smart-контейнері відкрийте поле Знижка та натисніть правила зіставлення.
- Вставте selector у поле.
- Натисніть Перевірте правило та збережіть.

Якщо правило задано правильно, значення підтягнеться зі сторінки товару.

ПриміткаЗазвичай вебсайти використовують стандартні назви CSS-селекторів, тому налаштування smart-контейнерів можна застосувати до більшості сторінок, що відповідають стандартам CSS. Деякі сторінки можуть містити індивідуальні назви селекторів або нестандартні атрибути. У такому випадку потрібні додаткові налаштування або створення нового smart-контейнера. Те саме стається, коли сторінка, яка раніше працювала, перестає віддавати значення: якщо редактор повідомляє, що поле не знайдене за посиланням, відкрийте правила співставлення й оновіть його селектор, бо розмітка сторінки змінилася.
Кроки з налаштування нового контейнера подібні до описаних у розділі Додавання додаткових параметрів. Змінні й правила зіставлення потрібно створити для кожного елемента окремо.
Якщо виникнуть питання щодо налаштування smart-контейнерів, зверніться до служби підтримки за адресою [email protected].
Updated 7 days ago