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

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

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

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

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

1. Выберите тип импорта — «Клиенты».
2. Выберите действие:
   • «Добавить новых клиентов» — загружает только тех клиентов, которых нет в базе, существующих не редактирует.
   • «Добавить и отредактировать» — загружает новых клиентов и обновляет данные существующих.

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

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

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

   Доступные для загрузки поля

   • Email-адрес
   • Email подтвержден в формате true/false
   • Мобильный телефон
   • Мобильный телефон подтвержден в формате true/false
   • Номер дисконтной карты
   • Идентификатор зоны клиента
   • Фамилия
   • Имя
   • Отчество
   • ФИО
   • Пол
   • Дата рождения
   • Глобальная подписка в формате true/false
   • Подписка в точке контакта в каналах Email, SMS, Viber, MobilePush, WebPush в формате true/false
   • Подписка на тематики в точке контакта в каналах Email, SMS, Viber, MobilePush, WebPush в формате true/false

   Мультибренд

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

   • Дополнительные поля, созданные на проекте

2. При необходимости выгрузите данные из другой системы.

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

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

   

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

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

   

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

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

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

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

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

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

   

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

На этом шаге можно задать дополнительные параметры действия импорта:

• Источник данных — точка интеграции, указывает, откуда пришли данные. Влияет на атрибуцию действий клиента. По умолчанию используется «Административная панель Mindbox».
• Точка контакта — определяет, к какому каналу или интеграции будет привязано действие. По умолчанию определяться автоматически по точке интеграции. Если нужно явно привязать клиентов к конкретному сайту или магазину, выберите нужную точку вручную.
• Действие-источник — с каким действием клиент попадет в базу. Например, «Создание клиента». Влияет на сегментацию и аналитику.
• Сегментация — статическая сегментация, в который будут добавлены все клиенты из файла.
• Комментарий - описание импорта, помогает быстрее найти импорт в общем списке.

Задать шаблон действияЗадать шаблон действия

Если нужного шаблона еще нет на проекте, создайте его заранее или перейдя по ссылке со страницы импорта. Категории укажите исходя из бизнес-задачи.

---

Задать точку контактаЗадать точку контакта

Если нужной точки еще нет на проекте, создайте ее заранее или перейдя по ссылке со страницы импорта.

---

Как подписать клиентов на брендКак подписать клиентов на бренд

При использовании мультибренда на проекте бренд точки интеграции определяет бренд подписки клиента, которая передается через поля: IsSubscribed, IsSubscribedByEmail и IsSubscribedByEmailOnNews.

1. Определите точку интеграции вашего бренда. Для этого перейдите в раздел «Интеграции».

2. Выберите бренд через фильтр и подберите точку интеграции для импорта. Например, необходимо подписать клиента на рассылки бренда Demo. Возьмем для этого точку интеграции сайта:

   

3. Укажите эту точку интеграции на шаге «Настроить импорт»:

   

---

Загрузить в сегментЗагрузить в сегмент

Выберите статический сегмент. Если подходящего сегмента еще нет — создайте новый по инструкции.

Использовать другое времяИспользовать другое время

Отдельной настройки по времени нет, поэтому можно указать только с помощью колонки SourceDateTime для действия-источника и LastUpdateDateTime для действия редактирования:

Если не включать в файл данные столбцы, действия запишутся по времени выполнения задачи импорта.

---

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

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

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

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

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

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

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