Как обнулить балльные счета клиентов по файлу

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

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

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

1. Выберите тип импорта — «Лояльность → Балльные счета».
2. Выберите действие — «Обнулить балльные счета».

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

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

   Поле	Обязательно	Описание
   Идентификатор клиента Номер дисконтной карты	✅ Должен быть указан хотя бы один	При передаче идентификатора клиента, укажите в настройках импорта тип идентификатора (Email, телефон, Mindbox ID или внешний идентификатор)
   Внешний идентификатор точки контакта	Да, если не указан в настройках импорта	Точка контакта, с которой связано обнуление баланса (например, сайт или магазин)
   Системное имя балльного счета	Да, если не указан в настройках импорта	Балльный счет, который нужно обнулить
   Системное имя действия изменения баланса	❌	Доступен только шаблон действия с системным именем UserBalanceChangedFromAdminSite
   Комментарий к изменению баланса	❌	Произвольный текст. Два типа комментария: Причина для клиента (Comments) Причина для показа на административном сайте (AdminSiteComments)
   Дополнительные поля действия	❌	Любые дополнительные поля, настроенные на проекте для сущностей «Действие клиента»

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

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

   

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

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

   

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

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

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

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

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

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

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

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

• Источник данных — точка интеграции, через которую пришли данные. Влияет на атрибуцию действий клиента.
• Точка контакта — определяет канал или интеграцию, к которой будет привязано обнуление баланса. По умолчанию определяется автоматически по точке интеграции. Можно указать вручную или передать в файле.
• Бренд — доступен для мультибрендовых проектов. Указывает, в рамках какого бренда произошло обнуление баланса.
• Идентификатор клиента — тип идентификатора, по которому клиент будет найден в базе (Email, мобильный телефон, Mindbox ID или внешний идентификатор). Сами значения передаются в файле в колонке «Идентификатор клиента, переданной в настройках».
• Балльный счет — счет, который нужно обнулить, если не передан в файле.
• Комментарий — описание импорта, помогает быстрее найти импорт в общем списке.

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

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

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

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

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

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

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

Результат импортаРезультат импорта

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