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

Шаг 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] Вы увидите: сколько оплат прошло, общую сумму, среднюю сумму транзакции и динамику по времени.