Как импортировать клиентов
  • 08 Sep 2022
  • 2 минуты
  • Темная тема
    Светлая тема
  • формат pdf

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

  • Темная тема
    Светлая тема
  • формат pdf

Для загрузки клиентов на проект достаточно подготовить файл в корректном формате и поставить задачу на импорт.

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

Импорт клиентов


Подбираем названия для колонок с email, именем, фамилией, датой рождения и подпиской на Email. На проект уже добавили дополнительное поле для оценки, но нет полей для хранения внешнего идентификатора, хобби и комментария. Создаем для них дополнительные поля — они также появляются в списке.

  1. На вкладке Клиенты нажимаем «Импорт» -> «Импорт клиентов»:

Снимок экрана 2022-06-08 в 19.26.45.png

  1. Выбираем операцию «Импорт клиентов»:

Снимок экрана 2022-09-07 в 22.30.11.png
Для скачивания доступен шаблон с примером. Также на странице появляются данные по всем возможным полям для загрузки: их название, описание и обязательность с примерами принимаемых форматов.

  1. Подготавливаем файл.

В первой строке указываются названия полей, в которые нужно загрузить данные по клиенту.
Формат — .csv
Кодировка — по умолчанию utf-8. Можно проверить кодировку своего файла с помощью текстовых редакторов вроде Notepad++, VS Code и т.д.

Рассмотрим все поля, которые можно передавать в файле.

Базовые поля

Есть на всех проектах.

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

Дополнительные поля

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

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

Если вы создаете дополнительное поле типа «Уникальный идентификатор», название сформируется в виде: ExternalIdentityСистемноеИмяПоля

Пример заполненного файла:
Снимок экрана 2021-07-08 в 17.02.16.png

  1. Ставим задачу:

Снимок экрана 2022-09-08 в 22.36.55.png

  • Появляется ссылка на неё:

Снимок экрана 2022-09-08 в 22.28.54.png

  • Ждём завершения:

Снимок экрана 2022-09-08 в 22.32.36.png

  • Готово:

Клиенты добавляются с шаблоном «Создание клиента» в точке контакта «Административный сайт Mindbox» по времени выполнения задачи:

Снимок экрана 2022-09-08 в 19.04.00.png

Клиенты, которые уже были в базе, получают шаблон «Редактирование клиента» в точке контакта «Административный сайт Mindbox» по времени выполнения задачи:

Снимок экрана 2022-09-08 в 19.03.49.png

Расширенные настройки

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

Их можно указать в настройках (сработает для всех в файле) или в файле (значение для каждого клиента будет браться из данных в его строке).

Расширенные настройки:

Снимок экрана 2022-09-08 в 15.02.10.png

  • Точка интеграции — источник данных. По умолчанию — Административная панель Mindbox.
  • Точка контакта. По умолчанию определяться автоматически по точке интеграции. Можно заменить на любую другую.
  • Действие-источник — с каким действием клиент попадет в базу.
  • Действие для существующих клиентов — какое действие будет выдано клиентам, которые уже есть на проекте. Можно использовать тот же шаблон, что в действии-источники.

Использовать другой шаблон действия

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

У всех в файле одинаковый шаблон
Указываем в настройках:

Снимок экрана 2022-09-08 в 16.53.11.png
Задаем свои шаблоны и для создания, и для редактирования.

У клиентов в файле разные шаблоны
Указываем в файле с помощью колонки SourceActionTemplate для действия-источника и LastUpdateActionTemplate для действия редактирования. Вписываются системные имена шаблонов:


Задаем свои шаблоны только для создания.

В настройках при этом отмечаем пункт «Брать значение из файла»:

Снимок экрана 2022-09-08 в 17.22.33.png
В настройках у шаблона создания отмечаем, что значения нужно брать из файла. Для существующих оставляем значение по умолчанию.

Использовать другую точку контакта

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

У всех в файле одинаковая точка контакта
Выбираем в настройках точку интеграции с нужной точкой или указываем ее явно:

Снимок экрана 2022-09-08 в 17.41.45.png

У клиентов в файле разные точки контакта
Указываем в файле с помощью колонки SourcePointOfContact для действия-источника и LastUpdatePointOfContact для действия редактирования. Вписываются внешние идентификаторы точек:

В настройках отмечаем пункт «Брать значение из файла»:

Снимок экрана 2022-09-08 в 17.55.59.png

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

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

Снимок экрана 2022-09-08 в 18.00.21.png

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


Была ли эта статья полезной?