Кастомеры: как идентифицировать кастомеров

Кастомеры

Версия: v2Дата: 15.06.2026

Какие сигналы используются

Gateway требует, чтобы у события был хотя бы один identity-сигнал: customerUUID, uuidVisitor, softId, email, phone или fingerprint. Без этого событие невозможно надёжно привязать к человеку или устройству.

Кастомеры: identity-сигналы — В списке клиентов проверяйте email, phone и custom fields, которые участвуют в идентификации.

Рекомендуемый порядок

Если customer уже известен — передавайте customerUUID.
Если customer есть в CRM — передавайте стабильный softId.
Если есть контакт — передавайте email или phone.
Для anonymous поведения передавайте uuidVisitor или fingerprint.
Когда пользователь авторизовался, отправьте событие с более сильным сигналом, чтобы связать историю.

Кастомеры: timeline после идентификации — После связывания события должны появиться в карточке клиента.

Ошибки, которых нужно избегать

Передавать каждый раз новый softId.
Передавать email в разных регистрах и форматах без нормализации.
Считать fingerprint полноценным customer id.
Создавать дубли клиентов через импорт без hard-id.
Отправлять события без identity-сигнала.

Технически: пользователь работает во frontend через REST в gateway. Внутри CDP используется контур gateway → cdp_customer; события связаны через customerUUID, uuidVisitor, softId, email, phone и fingerprint. Пользователю это нужно знать только для диагностики: если UI показывает ошибку, смотрите route, HTTP-статус gateway и связанный сервис.

Кастомеры: редактирование identity данных — Меняйте contact/identity поля осторожно: они влияют на дальнейшую склейку событий.