Контакты — управление клиентской базой

Что такое CDP в Trigly

CDP (Customer Data Platform) — это единая база контактов, которая собирает данные из всех источников: загрузки CSV, ручного ввода, SDK-событий с сайта, API-интеграций с CRM.

Каждый контакт в Trigly имеет 45+ полей и 360-профиль — полную историю взаимодействий: кампании, открытия, клики, покупки, события, RFM-метрики.

---

Способы добавления контактов

CSV-импорт

Основной способ для массового добавления. Поддерживает до 100 000 контактов за один файл.

Подготовка файла:

1. Создайте таблицу в Excel или Google Sheets
2. Первая строка — заголовки колонок: email, first_name, last_name, phone, city
3. Сохраните как CSV (UTF-8, разделитель — запятая)

Обязательные поля: хотя бы одно из email или phone. Без идентификатора контакт не будет создан.

Процесс импорта:

1. Контакты > Импорт > Загрузить файл
2. Trigly анализирует файл и показывает предпросмотр первых 5 строк
3. Сопоставление полей (mapping):
   • Колонка «email» → поле Trigly «Email»
   • Колонка «имя» → поле Trigly «Имя»
   • Незнакомые колонки → можно создать как пользовательское поле
   • Ненужные колонки → пропустить
4. Дедупликация: выберите поле для поиска дубликатов:
   • По email — рекомендуется для email-рассылок
   • По телефону — для SMS-рассылок
   • По email И телефону — строгая проверка
5. Правило при дубликате:
   • Обновить существующий контакт (новые данные перезаписывают старые)
   • Пропустить дубликат (сохранить старые данные)
6. Нажмите Начать импорт

Статусы импорта:

• uploaded — файл загружен, ожидает обработки
• processing — идёт сопоставление и валидация
• importing — контакты записываются в базу
• completed — импорт завершён
• failed — ошибка (например, битый файл или неверная кодировка)

Ручное добавление

1. Контакты > Добавить контакт
2. Заполните поля в форме
3. Нажмите Сохранить

Удобно для добавления одного-двух контактов на лету.

Через API

curl -X POST https://api.trigly.ru/api/v1/cdp/customers \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "new@example.com",
    "first_name": "Пётр",
    "phone": "+79161234567",
    "tags": ["новый", "партнёр"],
    "custom_fields": {"компания": "ООО Ромашка"}
  }'

Подробнее: CDP API Reference.

Через JavaScript SDK

Установите SDK на сайт — контакты будут создаваться автоматически:

trigly('identify', {
  email: 'user@example.com',
  first_name: 'Иван',
  phone: '+79161234567'
});

Подробнее: JavaScript SDK.

---

Поля контакта

Стандартные поля

Поле	Тип	Описание
email	string	Email, основной идентификатор
first_name	string	Имя
last_name	string	Фамилия
phone	string	Телефон в международном формате
city	string	Город
country	string	Страна
timezone	string	Часовой пояс (для умной отправки)
tags	string[]	Теги для категоризации
lifecycle_stage	enum	Стадия: new, active, loyal, at_risk, churned
data_quality_score	int	Качество данных: 0-100

Полный список полей: CDP API Reference.

Пользовательские поля

Можно добавить любые поля, нужные вашему бизнесу:

• Размер скидки (число)
• Любимый бренд (строка)
• Дата последнего визита (дата)
• Количество детей (число)
• Подписка на новости (да/нет)

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

Теги

Теги — способ категоризации контактов без создания формальных сегментов:

• vip, оптовик, партнёр — категории клиентов
• ждёт_звонка, интерес_к_X — статусы и интересы
• email_невалиден, дубликат — служебные пометки

Один контакт может иметь несколько тегов. Теги можно использовать в условиях сегментов и фильтрах.

---

Сегменты

Сегмент — это сохранённый фильтр контактов, который можно использовать в кампаниях.

Типы сегментов

Динамический сегмент — автоматически обновляется при изменении данных:

• Контакт изменил город → автоматически перешёл в другой сегмент
• Новый контакт подходит под условия → автоматически добавлен
• Контакт перестал подходить → автоматически удалён

Статический сегмент — фиксированный список, не меняется:

• Загружен вручную из CSV
• Результат одноразовой выборки
• Не меняется при изменении контактов

Создание динамического сегмента

1. Контакты > Сегменты > Создать
2. Название: «VIP Москва»
3. Тип: Динамический
4. Добавьте условия:

Город равно Москва
И
Теги содержит vip

5. Нажмите Сохранить

Доступные операторы

Тип поля	Операторы
Строка	равно, не равно, содержит, не содержит, начинается с, пусто, не пусто
Число	равно, больше, меньше, между, пусто
Дата	сегодня, вчера, последние N дней, до даты, между датами, пусто
Теги	содержит, не содержит

Примеры сегментов

Сегмент	Условия	Применение
Новые за 7 дней	created_at в последние 7 дней	Приветственная серия
VIP	теги содержит vip ИЛИ LTV > 50 000	Персональные предложения
Брошенная корзина	событие added_to_cart за 24ч И НЕТ purchase за 24ч	Триггерная рассылка
Спящие 90д	last_activity_at > 90 дней назад	Реактивация
Открывали за 30д	last_open_at в последние 30 дней	Активная аудитория
Москва и МО	city равно Москва ИЛИ city равно Московская область	Гео-кампании
День рождения завтра	birth_date — завтра	Поздравление + промокод

---

RFM-анализ

RFM — это метод сегментации клиентов по трём метрикам:

• Recency (давность) — сколько дней назад была последняя покупка
• Frequency (частота) — сколько всего покупок совершил клиент
• Monetary (деньги) — на какую сумму в общей сложности купил

Как работает RFM в Trigly

1. Контакты > RFM-анализ > Запустить анализ
2. Trigly вычисляет RFM-метрики для каждого контакта на основе событий purchase
3. Каждому контакту присваиваются три оценки: R, F, M (каждая от 1 до 5)
4. Контакты распределяются по RFM-сегментам

RFM-сегменты (примеры)

Сегмент	R	F	M	Описание
Чемпионы	5	5	5	Лучшие клиенты: покупают часто, недавно, на большие суммы
Лояльные	3-4	4-5	4-5	Постоянные клиенты, стабильный доход
Новые	5	1	1-3	Первая покупка недавно, нужен онбординг
Под угрозой	1-2	4-5	4-5	Раньше покупали много, но давно не было покупок
Спящие	1	1-2	1-2	Давно не покупали, низкая частота и сумма

Использование RFM в кампаниях

• Чемпионам — персональные предложения, ранний доступ к новинкам
• Под угрозой — «Мы скучаем», персональная скидка
• Спящим — реактивация с сильным стимулом (большая скидка, подарок)
• Новым — приветственная серия, кросс-продажи

RFM-сегменты используются как обычные сегменты в кампаниях и потоках.

---

Дедупликация и очистка данных

Автоматическая дедупликация

При импорте Trigly автоматически находит и объединяет дубликаты по выбранному ключу (email или телефон). Правило объединения:

• Непустые значения имеют приоритет над пустыми
• Новые значения перезаписывают старые (кроме случая «пропустить дубликат»)
• Теги объединяются (старые + новые)

Очистка невалидных адресов

Trigly автоматически отслеживает:

• Жёсткие bounces (несуществующие адреса) — помечаются и исключаются
• Спам-жалобы — контакт немедленно исключается из всех рассылок
• Неактивные — не открывали письма 180+ дней

Все исключённые контакты попадают в suppression list и не получают сообщения ни по одному каналу.

Оценка качества данных

Каждый контакт имеет data_quality_score (0-100):

• 100 — все ключевые поля заполнены, email валиден, данные актуальны
• 50-70 — есть основные поля, но не хватает важных (телефон, город)
• 0-30 — минимум данных, возможны ошибки

Фильтр по качеству данных помогает исключить «мусорные» контакты из важных кампаний.

---

Экспорт данных

1. Контакты > Экспорт
2. Выберите формат: CSV или JSON
3. Выберите область: все контакты, конкретный сегмент или результат поиска
4. Выберите поля для экспорта
5. Нажмите Экспортировать

Файл формируется асинхронно. При готовности вы получите уведомление и ссылку на скачивание.