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

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

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

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

Шаг 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 показывает первые строки файла с уже примененными сопоставлением. Убедитесь, что данные выглядят ожидаемо: правильные значения попали в правильные поля.

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

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

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

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

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