Сопоставление полей и роли
Чтобы поиск понимал, «что есть что» в вашем фиде, каждое ключевое поле получает роль — семантическую метку. Роли отвязаны от конкретных имён тегов: у разных магазинов название товара может лежать в <name>, <model> или нестандартном теге — роль «Название» указывает на нужный.
Роли полей
| Роль | Обяз. | Что означает |
|---|---|---|
| Идентификатор | ✅ | Уникальный id товара. |
| Название | ✅ | Имя товара для показа и поиска. |
| Цена | ✅ | Цена товара. |
| Ссылка | ✅ | Ссылка на карточку. |
| Категория | ✅ | Категория (с деревом предков). |
| Изображение | ✅ | Главное изображение. |
| Группа SKU | — | Объединение вариантов (группировка). |
| Наличие | — | В наличии / нет. |
| Производитель | — | Бренд. |
| Описание | — | Описание товара. |
| Старая цена | — | Для подсветки скидки. |
| Все изображения | — | Галерея. |
Обязательные роли
Шесть ролей обязательны — без них проект не создать: Идентификатор, Название, Цена, Ссылка, Категория, Изображение. Мастер создания проекта требует сопоставить каждую из них с полем фида (идентификатор берётся из атрибута id оффера).
Автоподбор при анализе фида
На шаге анализа мастер сканирует фид и по каждому найденному полю показывает:
- % заполненности (подсвечено: ≥80 % зелёным, ≥50 % жёлтым, ниже — красным);
- примеры значений.
Для обязательных ролей мастер сам предлагает подходящее поле, распознавая типовые русские и английские названия (name/наименование, price/цена, url/ссылка, picture/фото и т. п.). Автоподбор — подсказка: финальное решение вы принимаете в мастере.
Настройка в личном кабинете
После создания проекта поля и характеристики настраиваются на странице проекта «Настройка выдачи».
Часть полей вычисляется сервисом (например, «Наличие» или список категорий с их родителями) — у таких полей набор настроек ограничен. Поля из тегов фида настраиваются полностью.
Для каждого поля можно задать: участие в поиске, поиск по подстроке, вес в поиске, роль фильтра, сортировку и отображение (видимость поля в выдаче). Как именно карточка показывает данные (заголовок, цена, картинка, бейджи) — задаётся не здесь, а в редакторе виджета.
Когда нестандартный тег начинает работать
Поле из нестандартного тега влияет на поиск/фильтры/выдачу, только если ему включена хотя бы одна роль (поиск, фильтр или сортировка) в личном кабинете. Один флаг «Отображение» тег не активирует — поле останется пустым. Стандартные теги работают сразу.
Порядок фильтров
Фильтры идут в витрине в том порядке, который задан в личном кабинете: что выше в списке — то выше и в блоке фильтров. Порядок общий для полей и характеристик, поэтому фильтр по характеристике («Бренд») можно поставить выше фильтра по полю («Цена»). В этом же порядке выстраиваются варианты сортировки выдачи.
Меняется он кнопкой «Порядок фильтров» над таблицей полей или характеристик: в открывшемся окне все фильтры проекта показаны одним списком — перетащите строку за ручку или сдвиньте стрелками.
TIP
В списке видно всё, у чего включена роль фильтра, — включая элементы с выключенным «Отображением». Такие помечены отдельно: место в порядке за ними закреплено, но в витрину они не попадают, пока отображение не включено.
Поля и характеристики, приехавшие с очередным обновлением фида, встают в конец списка — настроенный порядок они не сдвигают.
Порядок отвечает только за показ. На то, насколько поле важно при поиске, влияет «Вес в поиске», и перестановка фильтров выдачу не меняет.
Имена полей в API поиска
В ответе поискового API поле возвращается под своим служебным именем: для стандартных полей — name, price, url, …; для нестандартных тегов имя формируется автоматически (латиницей из названия тега). Это служебное имя в личном кабинете сейчас доступно только для чтения (редактируется лишь подпись поля в интерфейсе, на имя в API она не влияет). Полный разбор ответа — в «Итоговом документе».