Как импортировать клиентов
  • 17 Nov 2023
  • 3 минуты
  • Темная тема
    Светлая тема
  • формат pdf

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

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

Article Summary

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

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

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


Подбираем названия для колонок с 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

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

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

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

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

Снимок экрана 2023-06-26 в 10.28.12.png

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

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

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

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

Снимок экрана 2023-06-26 в 10.40.40.pngЗадаем свои шаблоны для создания.

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

Действие редактирования можно указать только в файле и только с шаблоном категории «Личное действие».
В остальных случаях изменения клиента сохраняются без записи действия.

Вписываются системные имена шаблонов:


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

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

Снимок экрана 2023-06-26 в 10.44.06.png

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

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

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

Снимок экрана 2023-06-26 в 10.50.35.png

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

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

Снимок экрана 2023-06-26 в 10.51.11.png

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

Выберите статический сегмент или создайте новый в открывшемся окне:

Снимок экрана 2023-06-26 в 11.03.18.png

Снимок экрана 2023-06-26 в 11.00.18.png

Снимок экрана 2023-06-26 в 11.02.22.png

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

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

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

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


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