Как импортировать контакты из CSV в Trigly
Пошаговая инструкция: подготовка CSV, upload, preview, маппинг полей, дедупликация. Импорт 100K контактов за 5 минут.
Зачем импортировать контакты
Импорт — первый шаг при начале работы с Trigly CDP. Вам нужно перенести существующую клиентскую базу из:
- CRM-систем: Bitrix24, amoCRM, RetailCRM, 1C
- Email-сервисов: Mailchimp, Unisender, SendPulse
- Таблиц: Excel, Google Sheets
- Баз данных: выгрузка из PostgreSQL, MySQL, MongoDB
- Рекламных платформ: Яндекс.Метрика, Google Analytics (аудитории)
Trigly принимает CSV-файлы с автоматическим маппингом полей и интеллектуальной дедупликацией. Профиль клиента в CDP содержит 45+ полей — от базовых (email, телефон, имя) до аналитических (RFM-сегмент, AI-скоринг, lifecycle stage).
При импорте вы загружаете доступные данные, а Trigly автоматически рассчитает остальные: RFM-сегменты, AI-скоринг, data quality score, lifecycle stage и computed fields (средний чек, частота покупок).
Подготовка CSV-файла
Обязательные требования
- Кодировка: UTF-8 (или UTF-8 with BOM для файлов из Excel)
- Разделитель: запятая (,) или точка с запятой (;) — Trigly определяет автоматически
- Первая строка: заголовки колонок
- Минимум одно поле-идентификатор: email, phone или external_id
Рекомендуемая структура колонок
Базовые поля (рекомендуемый минимум):
| Колонка | Описание | Пример |
|---|---|---|
| Email-адрес (основной идентификатор) | ivan@example.ru | |
| phone | Телефон (формат +7...) | +79001234567 |
| first_name | Имя | Иван |
| last_name | Фамилия | Петров |
| city | Город | Москва |
| country | Страна | Россия |
Расширенные поля (повышают качество CDP-профиля):
| Колонка | Описание | Пример |
|---|---|---|
| tags | Теги через запятую | VIP,новинки,скидки |
| source | Источник привлечения | website,instagram |
| external_id | ID из внешней системы | crm-12345 |
| total_revenue | Суммарная выручка | 15990.00 |
| total_orders | Количество заказов | 3 |
| timezone | Часовой пояс | Europe/Moscow |
| language | Язык | ru |
| custom_fields | JSON с кастомными полями | {"size": "L"} |
Чем больше полей вы заполните, тем выше будет data quality score и точнее AI-предсказания.
Подготовка данных из популярных систем
Из Bitrix24: Выгрузка контактов → CSV → переименуйте колонки (ФИО → first_name + last_name, Телефон → phone).
Из Mailchimp: Audience → Export → CSV. Колонки Email Address, First Name, Last Name маппятся автоматически.
Из Google Sheets: Файл → Скачать → CSV (UTF-8). Убедитесь, что телефоны сохранены как текст (формат +7...), а не как числа.
Из 1С: Выгрузка справочника контрагентов → обработка в Excel → сохранение как CSV UTF-8.
Пошаговая инструкция импорта
Шаг 1: Загрузка файла (Upload)
Перейдите в CDP → Контакты → нажмите кнопку "Импорт" → "Загрузить CSV".
Выберите файл с компьютера. Максимальный размер — 50 МБ (примерно 500K контактов с 10 колонками).
Шаг 2: Предпросмотр (Preview)
Trigly покажет первые 10 строк для проверки. Убедитесь, что:
- Данные распознаны корректно (нет "кракозябр" в кириллице)
- Колонки разделены правильно (нет слипшихся значений)
- Числовые данные (revenue, orders) отображаются как числа
Если кодировка некорректна, пересохраните файл в UTF-8 (в Excel: Сохранить как → CSV UTF-8).
Шаг 3: Маппинг полей
Сопоставьте колонки CSV с полями CDP-профиля. Trigly автоматически определяет стандартные поля по названиям колонок:
email,Email,EMAIL,e-mail→ поле emailphone,Телефон,mobile→ поле phonefirst_name,Имя,name→ поле first_namelast_name,Фамилия,surname→ поле last_name
Для нестандартных названий колонок выберите поле вручную из выпадающего списка. Колонки, которые не соответствуют стандартным полям, можно сопоставить с custom_fields.
Шаг 4: Настройка дедупликации
Дедупликация определяет, что делать с контактами, которые уже есть в базе. Выберите поле-ключ:
- По email (рекомендуется) — самый надёжный идентификатор. Если контакт с таким email уже есть, его данные обновятся.
- По phone — подходит, если телефон — основной идентификатор (например, для SMS-базы).
- По external_id — если вы синхронизируете данные из CRM и хотите использовать внешний ID.
Поведение при дубликатах:
- Существующие контакты обновляются новыми данными (merge)
- Пустые поля в CSV не перезаписывают заполненные поля в CDP
- Теги (tags) объединяются — новые теги добавляются к существующим
- Новые контакты создаются автоматически
Шаг 5: Запуск импорта
Нажмите "Импортировать". Вы увидите прогресс-бар с текущим статусом.
По завершении — подробный отчёт:
- Создано новых контактов: N
- Обновлено существующих: M
- Ошибок (невалидные строки): K
- Пропущено (дубликаты в самом файле): L
Импорт через API
Для автоматизации регулярных импортов используйте REST API:
# 1. Загрузка файла
POST /api/v1/cdp/imports/upload
Content-Type: multipart/form-data
file: contacts.csv
# 2. Предпросмотр
GET /api/v1/cdp/imports/{import_id}/preview
# 3. Запуск с настройками
POST /api/v1/cdp/imports/{import_id}/start
{
"field_mapping": {
"Email": "email",
"Имя": "first_name",
"Телефон": "phone"
},
"dedup_field": "email"
}
# 4. Проверка статуса
GET /api/v1/cdp/imports/{import_id}
Что происходит после импорта
После успешного импорта Trigly автоматически запускает фоновые процессы:
- RFM-расчёт — если у контактов есть данные о покупках (total_revenue, total_orders), Celery-задача рассчитает RFM-сегменты по квинтильному методу
- AI-скоринг — AI-модель рассчитает скоринг (0-100) для каждого контакта
- Lifecycle stage — определение стадии жизненного цикла (new, active, at_risk, churned)
- Data quality score — оценка полноты и качества профиля (0-100)
- Computed fields — расчёт avg_order_value, purchase_frequency_days, days_since_last_purchase
- Динамические сегменты — обновление динамических сегментов с учётом новых контактов (каждые 30 минут)
Советы и лучшие практики
-
Очистите данные перед импортом — удалите дубликаты, невалидные email (без @), пустые строки. Чем чище входные данные, тем лучше результат.
-
Нормализуйте телефоны — приведите к формату +7XXXXXXXXXX (для России). Trigly не конвертирует 8-XXX в +7-XXX автоматически.
-
Разбивайте большие файлы — если у вас 1M+ контактов, разделите файл на части по 100-200K. Это ускорит обработку и снизит вероятность ошибок.
-
Импортируйте теги — теги позволяют быстро сегментировать базу без создания динамических сегментов. Добавьте колонку tags с тегами через запятую.
-
Используйте external_id — если данные приходят из CRM, всегда передавайте external_id. Это обеспечит корректную синхронизацию при повторных импортах.
-
Проверяйте через preview — никогда не пропускайте шаг предпросмотра. 30 секунд проверки сэкономят часы на исправление ошибок.
Распространённые ошибки
- Неправильная кодировка: файл из Excel на Windows часто имеет кодировку Windows-1251. При импорте кириллица превращается в мусор. Решение: пересохраните как CSV UTF-8.
- Телефоны как числа: Excel автоматически удаляет ведущий "+" и нули. Результат: +79001234567 → 79001234567 или 7.9E+9. Решение: форматируйте колонку телефонов как текст перед сохранением.
- Пустые email: строки без email и без phone пропускаются — Trigly требует хотя бы один идентификатор.
- Дубликаты в самом файле: если в CSV два контакта с одинаковым email, будет обработан последний. Удалите дубликаты заранее.
- Слишком много кастомных полей: десятки колонок custom_fields замедляют импорт и захламляют профиль. Импортируйте только бизнес-значимые поля.
Ожидаемые метрики
| Размер файла | Кол-во контактов | Время импорта | Время RFM-расчёта |
|---|---|---|---|
| 1 МБ | ~10K | 10-30 сек | 5-10 сек |
| 10 МБ | ~100K | 2-5 мин | 30-60 сек |
| 50 МБ | ~500K | 10-20 мин | 2-3 мин |
Время зависит от количества колонок, сложности дедупликации и нагрузки на систему.
Часто задаваемые вопросы
Можно ли отменить импорт?
Нет, после запуска импорт нельзя отменить. Однако вы можете использовать bulk delete для удаления контактов, созданных импортом (фильтр по дате создания + source).
Поддерживаются ли форматы кроме CSV?
На данный момент импорт поддерживает только CSV. Для JSON-данных используйте API-эндпоинт создания контактов (POST /api/v1/cdp/customers) или SDK-метод trigly.identify().
Что делать, если при импорте много ошибок?
Скачайте отчёт об ошибках — в нём указаны номера строк и причины (невалидный email, отсутствует обязательное поле, неверный формат данных). Исправьте проблемные строки и повторите импорт только для них.
Готовы перенести клиентскую базу в Trigly? Начните импорт прямо сейчас. После загрузки данных изучите возможности RFM-анализа, AI-скоринга и динамических сегментов, чтобы извлечь максимум из клиентских данных.