Как начать собирать бизнес-события в Konso (Value Tracking)
Пошаговая инструкция: подключите Value Tracking и начните трекать регистрации, оплаты и конверсии из вашего приложения за 10 минут.
Открыть Konso arrow_forwardTL;DR
- check_circleValue Tracking — трекинг именованных бизнес-событий с числовым значением и произвольным контекстом
- check_circleУстановите Konso.Client и зарегистрируйте IKonsoValueTracking в DI-контейнере
- check_circleВызовите valueTracking.TrackAsync(“event.name”, value, context) в точке бизнес-события
- check_circleСобытия появятся в разделе Value Tracking в Konso с агрегациями и фильтрами
- check_circleВ отличие от метрик, каждое событие сохраняет полный контекст — userId, сумму, канал и т.д.
Value Tracking vs метрики: в чём разница
Метрика — это агрегат: «среднее время ответа 142мс». Бизнес-событие в Value Tracking — это факт с контекстом: «пользователь X оплатил Y рублей методом Z в 14:23». Из событий можно строить любые агрегации постфактум. Из метрик восстановить контекст каждого события невозможно. Value Tracking — это observability для бизнес-результатов.
Что стоит трекать через Value Tracking
- check_circleРегистрация нового пользователя — события активации воронки
- check_circleУспешная оплата — с суммой, методом и идентификатором заказа
- check_circleПервое ключевое действие пользователя (first value moment)
- check_circleОтписка или отмена подписки — для оценки churn
- check_circleДостижение лимита или апгрейд тарифа
Предварительные требования
- check_circleАккаунт Konso на app.konso.io
- check_circleСозданный проект в Konso
- check_circleAPI токен проекта — получите в Настройки → API доступ
- check_circle.NET 6+ приложение
Шаг 1. Установите NuGet-пакет
Если Konso.Client ещё не установлен — добавьте пакет:
dotnet add package Konso.Client
[скриншот: терминал с успешной установкой пакета Konso.Client]
Шаг 2. Добавьте API токен в конфигурацию
В appsettings.json добавьте секцию Konso (или используйте существующую):
{
“Konso”: {
“ApiKey”: “ВАШ_API_ТОКЕН”
}
}
Для production храните токен в переменных окружения:
export Konso__ApiKey=“ВАШ_API_ТОКЕН”
[скриншот: appsettings.json с секцией Konso]
Шаг 3. Зарегистрируйте сервис Value Tracking
В Program.cs зарегистрируйте IKonsoValueTracking:
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddKonsoValueTracking(options =>
{
options.ApiKey = builder.Configuration[“Konso:ApiKey”];
});
var app = builder.Build();
[скриншот: Program.cs с добавленной строкой AddKonsoValueTracking]
После этого IKonsoValueTracking доступен через DI в любом классе приложения.
Шаг 4. Внедрите клиент и отправьте первое событие
Внедрите IKonsoValueTracking и вызовите TrackAsync в точке бизнес-события:
public class PaymentService
{
private readonly IKonsoValueTracking _valueTracking;
public PaymentService(IKonsoValueTracking valueTracking)
{
_valueTracking = valueTracking;
}
public async Task CompletePayment(string userId, decimal amount, string method)
{
// ... логика оплаты ...
// Трекаем бизнес-событие с контекстом
await _valueTracking.TrackAsync(
"payment.completed",
(double)amount,
new
{
userId = userId,
currency = "RUB",
method = method,
orderId = orderId
});
}
}
[скриншот: код PaymentService с вызовом _valueTracking.TrackAsync]
Первый аргумент — имя события (строка), второй — числовое значение (сумма, количество, баллы), третий — произвольный контекст в виде анонимного объекта.
Шаг 5. Добавьте события для ключевых точек воронки
Добавьте трекинг в остальные значимые точки вашего приложения:
// Регистрация нового пользователя
await _valueTracking.TrackAsync(“user.registered”, 1, new
{
userId = userId,
channel = “organic”,
plan = “free”
});
// Первое успешное действие (активация)
await _valueTracking.TrackAsync(“user.activated”, 1, new
{
userId = userId,
daysFromRegistration = daysSince
});
// Апгрейд тарифа
await _valueTracking.TrackAsync(“subscription.upgraded”, monthlyAmount, new
{
userId = userId,
fromPlan = oldPlan,
toPlan = newPlan
});
[скриншот: несколько TrackAsync-вызовов в разных сервисах — user.registered, user.activated, subscription.upgraded]
Шаг 6. Откройте раздел Value Tracking в Konso
Перейдите в Konso → ваш проект → раздел Value Tracking. После первых вызовов TrackAsync события появятся в списке.
[скриншот: раздел Value Tracking в Konso — список событий с названием, количеством, суммарным значением и временным графиком]
Каждое событие отображается с именем, агрегированным значением (sum/avg/count) и распределением по времени.
Шаг 7. Исследуйте данные с фильтрами
Выберите событие payment.completed и примените фильтры:
• Временной диапазон — за последние 7 дней, месяц или кастомный период
• Группировка по полю — например, по method (card, sbp, wallet)
• Агрегация — sum для суммарной выручки, count для количества оплат
[скриншот: детальный вид события payment.completed с фильтрами по периоду и группировкой по method]
Вы увидите: сколько оплат прошло, общую сумму, среднюю сумму транзакции и динамику по времени.
Альтернатива: отправка события через REST API
Для не-.NET платформ используйте прямую отправку через HTTP.
Именование событий
Используйте формат {объект}.{действие}: payment.completed, user.registered, subscription.upgraded, trial.started. Это создаёт читаемую иерархию событий в интерфейсе Konso и упрощает поиск при большом количестве event-типов.
Value Tracking + логи = полная диагностика
Когда оплата трекается через Value Tracking, а детали ошибок логируются через ILogger, вы можете сопоставить падение payment.completed с конкретными Error-логами в тот же период — и найти причину без ручной корреляции данных.
Что сделать после подключения
- check_circleОпределите 3–5 ключевых событий воронки и добавьте их трекинг
- check_circleСоздайте алерт при падении count события payment.completed ниже ожидаемого порога
- check_circleДобавьте userId во все события для возможности фильтрации по конкретному пользователю
- check_circleСравните динамику Value Tracking с техническими метриками — это покажет корреляции
- check_circleИспользуйте данные для оценки влияния деплоев на бизнес-метрики
Начните трекать бизнес-события уже сегодня
Подключите Value Tracking в Konso и получите полную картину бизнес-результатов вашего приложения
Начать бесплатно arrow_forwardЧастые вопросы
Можно ли передавать в контекст события произвольные поля? expand_more
Да, третий аргумент TrackAsync принимает произвольный объект. Все поля индексируются в Elasticsearch и доступны для фильтрации и группировки в интерфейсе Konso.
Нужно ли числовое значение, если событие не имеет суммы (например, регистрация)? expand_more
Передайте значение 1. Это позволит использовать агрегацию count (сколько раз событие произошло) и sum (будет равна count). Нулевое значение не рекомендуется — оно учитывается при агрегации avg.
Как отслеживать события из фронтенда (браузер, мобильное приложение)? expand_more
Используйте REST API — отправляйте POST-запрос на /v1/valuetracking с вашим API токеном. Важно: не передавайте API токен в клиентский код. Создайте серверный эндпоинт-прокси, который принимает события от клиента и перенаправляет их в Konso.
Value Tracking влияет на производительность приложения? expand_more
Нет. TrackAsync отправляет события асинхронно и не блокирует основной поток. Вызов возвращается немедленно, отправка происходит в фоне.
Можно ли использовать Value Tracking без модуля логирования? expand_more
Да, Value Tracking — независимый модуль Konso. Его можно подключить отдельно, без логирования или метрик.