Товарные маркеры

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

Раздел отвечает не за сам товар, а за шаблон такого маркера: его название, изображение, цвета, активность и особые признаки.

Список товарных маркеров — На скриншоте: каталог товарных маркеров с быстрым поиском и переходом в карточку маркера.

Для кого и когда нужен этот документ

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

назначение раздела
описание карточки маркера
смысл цветовых полей и признака Скидочный маркер
связь маркеров с карточкой товара и клиентскими витринами

Откройте эту страницу, если нужно:

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

1. Для чего нужен этот раздел

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

Типовые примеры:

Новинка
Хит
Рекомендуем
Сезон
Скидка

Такие маркеры полезны:

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

2. Как устроен интерфейс раздела

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

Основные поля карточки:

Наименование
Изображение
Цвет фона
Цвет фона (антагонист)
Цвет текста
Цвет текста (антагонист)
Цвет рамки
Цвет рамки (антагонист)
Скидочный маркер
Активен

Карточка товарного маркера — На скриншоте: карточка товарного маркера с названием, цветовыми настройками и переключателями Скидочный маркер и Активен.

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

Импорт и экспорт CSV

Кнопка CSV рядом с созданием маркера позволяет выгрузить текущую отфильтрованную и отсортированную выдачу или загрузить файл для массового создания и обновления.

В экспорт входят следующие колонки:

Колонка	Значение	Обязательна	Пример
id	Системный ID для точного обновления существующего маркера.	Нет	019ff594-2e34-760e-bb4c-c44dc2c95b09
name	Наименование маркера. Без id используется для поиска существующего маркера без учёта регистра.	Да	Хит продаж
background_color	Основной цвет фона маркера.	Нет	#FDE047
background_color_opposite	Цвет фона для противоположной темы.	Нет	#713F12
border_color	Основной цвет рамки маркера.	Нет	#EAB308
border_color_opposite	Цвет рамки для противоположной темы.	Нет	#FACC15
text_color	Основной цвет текста маркера.	Нет	#422006
text_color_opposite	Цвет текста для противоположной темы.	Нет	#FEF9C3
is_discount	Признак скидочного маркера: true или false.	Нет	false

image и is_active не входят в CSV и не меняются импортом. Пустое или отсутствующее цветовое поле очищает соответствующий цвет, а пустой is_discount означает false.

Если указаны одновременно id и name, они должны соответствовать одному маркеру. Неизвестный ID, неоднозначное имя и повторяющиеся строки одного маркера остановят импорт с указанием строк файла.

3. Что означают основные поля

Наименование

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

Изображение

В карточку маркера можно добавить отдельную картинку.

Если изображение выбрано, Mini App показывает его внутри маркера вместо текста.

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

Цветовые поля

Эти поля задают внешний вид маркера.

На практике они позволяют:

выбрать основной фон
выбрать рамку
выбрать цвет текста
подготовить дополнительный контрастный вариант оформления

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

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

Обычные и антагонистические цвета нужны для разных цветовых тем интерфейса. Если говорить проще:

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

Скидочный маркер

Это отдельный важный признак.

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

В витринах, Telegram Mini App и Max мини-приложении такой маркер показывается не как обычная метка товара, а как отдельная скидочная отметка на карточке товара.