Как импортировать действия

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

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

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

Выберите тип импорта — «Заказы и действия → Действия».
Выберите действие — «Добавить действия».

Каждая строка файла создает новое действие у клиента. Существующие действия импорт не изменяет и не удаляет.

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

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

Поле	Обязательно	Описание
Email Мобильный телефон Mindbox Id Внешние идентификаторы клиента	✅ Должен быть указан хотя бы один	Идентификатор или контакт клиента
Внешний идентификатор точки контакта	Да, если не указан в настройках импорта	Точка контакта, с которой будет создано действие (например, сайт или магазин)
Системное имя шаблона действия	Да, если не указан в настройках импорта	Шаблон, с которым будет создано действие
Дата и время выдачи действия по UTC	❌	Если не передано, используется текущая дата и время на момент выполнения задачи импорта
Id Product в {Внешняя система}	❌	Идентификатор продукта во внешней системе, связанного с действием
Id ProductGroup в {Внешняя система}	❌	Идентификатор группы продукта во внешней системе, связанного с действием
Дополнительные поля действия	❌	Любые дополнительные поля, настроенные в проекте для сущностей «Действие»

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

Рекомендации по подготовке и сохранению файла.
Загрузите файл для импорта и нажмите «Продолжить»:

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

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

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

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

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

Источник данных — точка интеграции, через которую пришли данные. Влияет на атрибуцию действий клиента.
Точка контакта — определяет канал или интеграцию, к которой будет привязано действие. По умолчанию определяется автоматически по точке интеграции. Можно указать вручную или передать в файле.
Бренд — доступен для мультибрендовых проектов. Указывает, в рамках какого бренда было выполнено действие.
Действие — шаблон, по которому будут созданы действия. Определяет категорию и логику обработки сценариями.

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

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

У всех в файле одинаковый шаблон

У клиентов в файле разные шаблоны

Укажите шаблон действия через настройки импорта — он применится ко всем строкам файла.

Укажите системное имя шаблона в файле импорта в отдельной колонке. В настройках при этом отметьте пункт «Взять значение из файла импорта»:

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

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

У всех в файле одинаковая точка контакта

У клиентов в файле разные точки контакта

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

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

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

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

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

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

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

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

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