Туториал

Как начать собирать бизнес-события в Konso (Value Tracking)

Пошаговая инструкция: подключите Value Tracking и начните трекать регистрации, оплаты и конверсии из вашего приложения за 10 минут.

Открыть Konso arrow_forward
bolt

TL;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.

tips_and_updates

Именование событий

Используйте формат {объект}.{действие}: payment.completed, user.registered, subscription.upgraded, trial.started. Это создаёт читаемую иерархию событий в интерфейсе Konso и упрощает поиск при большом количестве event-типов.

lightbulb

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. Его можно подключить отдельно, без логирования или метрик.