Как импортировать категории продуктов

Категория продуктов — это группа товаров, объединенных по общему признаку (например, «Верхняя одежда», «Аксессуары»). Категории могут быть вложенными и образовывать иерархию: у одной категории может быть родительская категория и несколько дочерних.

Категории продуктов используются для сегментации клиентов по интересам, настройки рекомендаций и персонализации коммуникаций.

Чтобы массово загрузить категории продуктов на проект, перейдите в раздел Данные → Импорт. Нажмите «Новый импорт», чтобы перейти к настройкам импорта:

Шаг 1. Выберите действие с даннымиШаг 1. Выберите действие с данными

• Выберите тип импорта — «Продукты → Категории продуктов».
• Выберите действие — «Добавить и обновить категории продуктов».

Шаг 2. Подготовьте и загрузите файлШаг 2. Подготовьте и загрузите файл

1. Определите, какие поля нужно загрузить.

   Поле	Обязательно	Описание
   Внешний идентификатор категории	✅	Уникальный идентификатор категории продуктов во внешней системе. Используется для идентификации категории при последующих обновлениях
   Название категории	❌	Отображаемое название категории
   Внешний идентификатор родительской категории	❌	Внешний идентификатор категории, в которую вкладывается текущая. Если поле не заполнено, категория будет верхнеуровневой

   Чтобы построить иерархию категорий, убедитесь, что родительская категория присутствует в файле (или уже загружена в проект) до того, как на нее ссылается дочерняя.

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

   • Формат файла — .csv или .txt.
   • Рекомендуемая кодировка — UTF-8.
   • Проверьте, что внешние идентификаторы записаны в корректном формате и уникальны в пределах внешней системы.

   

   В примере выше создаются:

   • категория Верхняя одежда с дочерними категориями Куртки и Плащи;
   • категория Аксессуары с дочерними категориями Очки и Ремни (со своей дочерней — Кожаные).

   Рекомендации по подготовке и сохранению файла.

3. Загрузите файл для импорта и нажмите «Продолжить»:

   

Шаг 3. Сопоставьте поля файлаШаг 3. Сопоставьте поля файла

Система автоматически сопоставляет поля из файла с полями в Mindbox. Проверьте результат и при необходимости скорректируйте его вручную:

1. В колонке «Импорт» отметьте галочками поля, которые нужно загрузить. Колонки без галочки будут пропущены.
2. В колонке «Поле Mindbox» сопоставьте каждую колонку файла с полями проекта. Необязательные поля без сопоставления будут пропущены.
3. Нажмите «Продолжить»:

Шаг 4. Настройте и запустите импортШаг 4. Настройте и запустите импорт

• Внешняя система, к которой будут прикреплены загружаемые категории. Внешние идентификаторы категорий уникальны в пределах одной внешней системы — это позволяет хранить независимые каталоги от разных источников (например, сайт и 1С).
• Комментарий — описание импорта, помогает быстрее найти импорт в общем списке.

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

Как отслеживать импортКак отслеживать импорт

После запуска импорт появится в списке на странице «Импорт». По каждой задаче отображаются:

• дата запуска,
• тип импорта,
• исходный файл с комментарием,
• прогресс загрузки,
• количество импортированных строк и ошибок,
• кто запустил.

Если в ходе импорта возникли ошибки — часть строк была пропущена. Откройте детали импорта, чтобы посмотреть, какие строки вызвали проблему и почему. Исправьте ошибки в файле и запустите импорт повторно.

Результат импортаРезультат импорта

После успешного завершения импорта категории появятся в разделе Данные → Продукты. Проверьте, что иерархия категорий построена корректно с помощью фильтра «Категории»: