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

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

Импорт выполняется в разделе Настройки → Импорт. Нажмите «Новый импорт» для перехода к настройкам:

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

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

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

1. Определите, какие поля нужно загрузить. В файле обязательно должен присутствовать идентификатор продукта во внешней системе — по нему Mindbox определяет, создать новый продукт или обновить существующий.

   Список необязательных полей

   Поле	Описание
   Имя	Название продукта
   Описание	Текстовое описание продукта
   Цена	Текущая цена продукта
   Старая цена	Предыдущая цена продукта
   Себестоимость	Себестоимость продукта
   Минимальная цена	Минимальная цена, до которой можно снижать стоимость
   Дата и время поступления (UTC)	Дата и время появления продукта в каталоге в формате UTC
   Ссылка	Ссылка на страницу продукта на сайте
   Ссылка на картинку	Ссылка на изображение продукта
   Артикул	Артикул продукта
   Доступность	Доступность продукта в формате true / false
   Срок годности	Срок годности в днях
   Название производителя	Производитель продукта. Как импортировать производителей на проект
   Внешние идентификаторы категорий продукта во внешней системе	Категории, к которым относится продукт. Можно передавать несколько категорий, разделяя их символом \|. Если указать категорию, которой нет на проекте, продукт попадет в верхнеуровневую «Неизвестную категорию»
   Идентификатор группы продуктов	Идентификатор группы, объединяющей вариации одного продукта (например, разные цвета или размеры)
   Системное имя бренда	Системное имя бренда, к которому относится продукт
   Дополнительные поля сущности «Продукт»	Дополнительные поля продукта, настроенные на проекте

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

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

   

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

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

   

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

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

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

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

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

2. Убедитесь, что данные выглядят ожидаемо: правильные значения попали в правильные поля. Если все верно — нажмите «Запустить импорт».

   

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

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

• дата запуска,
• тип импорта,
• кто запустил.

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

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

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

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