Как импортировать клиентов в статический сегмент

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

Чтобы загрузить до 10 файлов в разные сегменты за один раз, используйте массовый импорт.

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

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

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

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

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

   Поле	Системное имя	Обязательно	Описание
   Email Мобильный телефон Номер дисконтной карты ID клиента в Mindbox Другие идентификаторы клиента, созданные на проекте	CustomerEmail CustomerMobilePhone DiscountCard CustomerMindboxId CustomerExternalIdentity{Системное_имя}	✅ Должен быть указан хотя бы один	Идентификатор или контакт клиента
   Внешний идентификатор сегментации	SegmentationExternalId	Да, если не указан в настройках импорта	Сегментация, в сегмент которой добавляются клиенты
   Внешний идентификатор сегмента	SegmentExternalId	Да, если не указан в настройках импорта	Сегмент, в который добавляются клиенты

   Если сегмент не указан ни в настройках импорта, ни в файле, клиент будет удален из сегментации. Например, если он состоял в другом сегменте этой сегментации, он выйдет из него.

   Как найти идентификаторы сегментации и сегмента

   1. Перейдите в раздел «Данные → Сегментации».

   2. Найдите нужную статическую сегментацию и кликните по ее названию.

   3. Раскройте информацию для сегментации по кнопке «Дополнительно». Идентификатор находится в поле «Внешний ID»:

      

   4. Повторите для каждого из сегментов:

      

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

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

   

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

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

   

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

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

1. В колонке «Импорт» отметьте галочками поля, которые нужно загрузить. Колонки без галочки будут пропущены.

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

   Если нужного дополнительного поля еще нет на проекте, его можно создать по кнопке «Создать дополнительное поле».

3. Нажмите «Продолжить»:

Шаг 4. Укажите сегментШаг 4. Укажите сегмент

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

---

Шаг 5. Проверьте и запустите импортШаг 5. Проверьте и запустите импорт

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

Если все верно — нажмите «Запустить импорт».

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

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

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

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

Массовый импортМассовый импорт

Массовый импорт позволяет одновременно загрузить до 10 файлов. Каждый файл запускается отдельным импортом в списке. Сопоставление полей, дополнительные настройки и предварительный просмотр пропускаются — поля определяются по системным именам полей.

Шаг 1. Подготовьте файлыШаг 1. Подготовьте файлы

В первой строке каждого файла укажите системные имена полей Mindbox вместо произвольных названий. Системные имена перечислены в таблице полей импорта.

Сегмент для каждого файла можно указать двумя способами:

• В файле. Добавьте колонку с системным именем сегментации;
• В настройках импорта. Выберите сегментацию из выпадающего списка для каждого файла.

Шаг 2. Загрузите файлы и запустите импортШаг 2. Загрузите файлы и запустите импорт

1. Выберите тип импорта.
2. Включите настройку «Массовый импорт».
3. Загрузите файлы.
4. Выберите для каждого файла сегментацию, если она не указана в файле.
5. Нажмите «Начать импорт».

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

После успешного завершения задачи клиенты появятся в выбранном сегменте.

• Сегмент отобразится в карточке клиента в блоке «Текущие сегменты»:

• Факт добавления — в «Истории»:

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