Real-Time Event Tracking

Защо event tracking-ът е основата

Без event-и маркетингът е гадаене. "Коя функция доведе до retention?" / "Какво съдържание конвертира?" / "Кога потребителите отпадат?" — всички изискват наблюдаемо поведение, не self-reported анкети.

Event tracking-ът е просто логване на user действия с контекст. Страница прегледана. Бутон кликнат. Количка обновена. Абонамент ъпгрейднат. Всеки event има име, потребител, timestamp и свойства.

Два начина за пращане на event-и

Client-side: JavaScript SDK

Пусни script tag на уебсайта. Извикай monfri.track('event_name', { property: value }) отвсякъде в кода. Автоматично handle-ва sessionization, page-view tracking, click tracking и form submission.

Server-side: REST API

POST event-и директно от backend-а ти. Използвай за чувствителни event-и (покупки, промени на абонамент), където не искаш client-side spoofing риск.

И двата пътя удрят същия pipeline и са неразличими downstream.

Ingestion pipeline-ът

1. Event пристига на нашия edge (Cloudflare-маршрутизиран)
2. Валидиран срещу базова схема (event име, user ID или анонимен ID)
3. На опашка към Redis Stream (~1ms латентност)
4. Обработен от BullMQ workers: identity resolution, trait computation, bot detection
5. Вмъкнат в ClickHouse (columnar analytics база) — 6ms медиана
6. Сегменти преизчислени ако event-ът засяга активен сегментен критерий
7. Webhooks задействани за abonнирани event типове
8. Real-time broadcast чрез Socket.IO за live dashboard обновления

От приет event до видим в dashboard-а: обикновено под 100ms end-to-end.

Защо ClickHouse

PostgreSQL е страхотен за транзакционни данни (user акаунти, поръчки), но се затруднява с милиарди event-и. ClickHouse е columnar analytics база, специално създадена за high-volume event ingestion и aggregation заявки.

В нашите benchmarks:

• PostgreSQL event insert: ~972ms медиана (bottleneck в мащаб)
• ClickHouse event insert: ~6ms медиана (162× по-бързо)
• Aggregation query (event-и последни 30 дни по потребител): PostgreSQL 14 секунди, ClickHouse 340ms

Затова Segment, Amplitude, Mixpanel всички работят върху ClickHouse (или подобни columnar stores) — това е правилният инструмент за работата.

Bot detection (4 слоя)

Ботове надуват числата ти и корумпират сегментите ти. Monfri ги филтрира на 4 слоя:

1. SDK-side: проверка за headless browser флагове (Puppeteer, Playwright и др.)
2. User agent patterns: известни bot низове (crawlers, scrapers) се отхвърлят
3. Burst detection: необичайни click rates в кратки прозорци маркират сесия
4. IP rate limiting: същото IP правещо 1000+ event-и/минута се изолира

Bot-флагнати event-и се логват, но се изключват от сегменти, аналитики и billable event count.

Схема и tracking plan

Monfri auto-открива event схемата ти (event имена, property ключове, value типове). Използвай го за:

• Валидиране, че нов код изпраща последователни схеми
• Генериране на документация за екипа ти
• Spot-check на cardinality (твърде много уникални стойности = вероятно bug)

Ако мигрираш от Segment, приемаме tracking-plan.json на Segment директно.

Лимити по план

• Starter: 50K tracked event-и/месец
• Growth: 1M tracked event-и/месец
• Scale: 10M tracked event-и/месец

Overages се таксуват на €12 за 50K event-и (без ДДС, без hard cutoff).