Трекинг событий
События — это то, что делают ваши клиенты: «зарегистрировался», «добавил в корзину», «оплатил». Передавайте их в Climails — и они станут топливом для сегментов, триггеров сценариев и атрибуции выручки.
Что понадобится
- API-ключ с правом записи событий
- Бэкенд или фронтенд, который шлёт запрос, когда что-то происходит
Отправьте одно событие
Отправьте POST на /v1/events с именем события, тем, кому оно принадлежит, и любыми свойствами. Идентифицируйте контакт по id, external_id или email.
curl https://api.climails.com/v1/events \
-H "Authorization: Bearer sb_live_<prefix>.<secret>" \
-H "Content-Type: application/json" \
-d '{
"name": "purchased",
"contact": { "email": "[email protected]" },
"occurred_at": "2026-07-01T10:24:00Z",
"properties": { "amount": 49.0, "currency": "USD", "plan": "pro" }
}'Отправляйте события пакетами
Заливаете историю или копите события? Отправляйте до 1000 событий разом на /v1/events/bulk вместо отдельного запроса на каждое.
Что дают события
- Сегменты — условия по событиям, например «совершил purchased за последние 30 дней» или «не менее 3 раз».
- Сценарии — запуск потока в момент прихода события (триггер по событию).
- Выручка — добавьте свойство amount и исходную рассылку, чтобы атрибутировать выручку в аналитике.
Частые вопросы
Как опознать контакт в событии?
По id, external_id или email. Если контакта ещё нет, событие свяжется с ним, как только он будет создан с совпадающим идентификатором.
Какой лимит на пакет?
До 1000 событий за один вызов /v1/events/bulk.
Можно сегментировать по числу повторов события?
Да — условия по событиям поддерживают оператор количества и временное окно (например, ≥ 3 раз за последние 30 дней).
Начните отправлять за минуты
Заведите бесплатный аккаунт, подключите домен и охватите аудиторию во всех каналах — карта не нужна.
Бесплатный тариф навсегда · Без карты · Запуск за минуты