Как импортировать значения дополнительного поля с типом «перечисление»

Дополнительное поле с типом «перечисление» позволяет выбрать значение из заранее заданного списка вариантов — например, город клиента или размер одежды.

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

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

import-page.png

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

  1. Выберите тип импорта — «Справочники → Дополнительные поля».
  2. Выберите действие — «Добавить и обновить значения перечислений дополнительных полей».

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

custom-fields-import-type.png

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

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

    Поле

    Обязательно

    Описание

    Идентификатор значения перечисления

    ✅

    Внешний идентификатор значения, который будет использоваться в импортах, операциях Mindbox API и сегментации

    Вариант значения перечисления

    ✅

    Значение, которое будет отображаться на проекте (например, в карточке клиента, действиях или фильтрах)

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

    • Формат — .csv или .txt.
    • Рекомендуемая кодировка — UTF-8.
    • Идентификаторы значений должны быть уникальными в рамках одного дополнительного поля.
    custom-fields-import-example.png
    Пример файла импорта значений перечисления

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

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

    custom-fields-import-upload.png

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

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

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

custom-fields-import-fields.png

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

  1. Задайте параметры:

    • Дополнительное поле (обязательно) — дополнительное поле с типом «перечисление», в которое будут загружены значения из файла. Если нужного поля еще нет на проекте, создайте его заранее в разделе Настройки → Системные → Дополнительные поля.
    • Комментарий - описание импорта, помогает быстрее найти импорт в общем списке.

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

    custom-fields-import-check.png

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

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

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

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

custom-fields-imports-list.png

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

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

custom-fields-import-result.png

Гайд по LTV: прогноз метрики с помощью машинного обучения
Предыдущая
Как создать дополнительное поле
Следующая
Как удалить дополнительное поле