Hodisalar ma’lumotnomasi
Kixo quyidagi keng tarqalgan eventlarni avtomatik yig‘adi; aniq to‘plam va uzatish formati platformaga qarab farq qiladi. Har bir eventda standart maydonlar bo‘ladi: device_id, session_id, timestamp va properties.
Avtomatik yig‘iladigan eventlar
| Event turi | Event nomi | Platforma | Xossalar |
|---|---|---|---|
screen_view | Ekran nomi | iOS, Android | screen_name, screen_class |
screen_visit | Aniqlangan ekran nomi | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, trigger metadata; iOS’da qo‘shimcha ravishda tap_count va scroll_count ham bo‘ladi |
page_view | page_view | Web | url, path, title, referrer |
tap | Element yorlig‘i | iOS, Android | target_class, target_text, screen_name |
click | click | Web | tag, path, text, href, x, y |
session_start | session_start | Web, iOS, Android | session_id; platformaga xos lifecycle konteksti |
session_end | session_end | Web, iOS, Android | session_id; Web’da yakun kuzatilsa, duration_ms ham bo‘ladi |
scroll_depth | scroll_25 … scroll_100 | Web | depth (25, 50, 75, 100), url, path |
interaction | rage_click | Web | tag, path, text, click_count, x, y |
interaction | dead_click | Web | tag, path, text, x, y |
error | js_error yoki unhandled_rejection | Web | message, stack, type |
crash | Crash turi | iOS, Android | message, stack, exception yoki signal konteksti |
network | network_request (Web); aggregate yoki route yorlig‘i (iOS) | Web roziligi, iOS roziligi | Tozalangan marshrut, method/status oilasi, davomiylik va natija |
performance | Metriка nomi (LCP, FCP, CLS, INP, TTFB) | Web | value, rating, id, delta |
heatmap_click | heatmap_click | Web | x, y, viewport_width, viewport_height, page_url, element_selector |
push_received | Push ID | iOS; integratsiya qilinganda Android/Web | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push ID | Barchasi (Android/Web uchun host integratsiyasi kerak) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | Push ID | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | Push ID | iOS; host integratsiyasi bilan Android/Web | push_id, kixo_campaign_id, interaction_type |
push_action | Push ID | iOS; host integratsiyasi bilan Android | push_id, kixo_campaign_id, action_id |
custom | Event nomingiz | Barchasi | Siz bergan istalgan key/value juftliklari |
Standart eventlar (nomi bo‘yicha taniladi)
Kixo o‘n birta kanonik event nomini taniydi. Ulardan istalganini Kixo.track("purchase", {amount: 49.99, currency: "USD"}) orqali kuzatsangiz, Kixo qabul qilish paytida eventga standard_kind qo‘yadi. Shundan keyin chat so‘rovlari, segmentlar va kampaniyalarda standard_kind = 'purchase' deb yozishning o‘zi kifoya — barcha aliaslar (purchase / purchased / purchase_completed / order_completed / checkout_completed)ni qo‘lda sanab o‘tirmaysiz.
Bu nomlar AI monetizatsiya / konversiya / aktivatsiya heuristikalariga ham xizmat qiladi — Kixo.track("purchase") hech qanday sozlamasiz daromad sifatida tushuniladi; ixtiyoriy amount_cents (yoki amount / value) xossasi daromad maqsadlari uchun yig‘iladi. Agar tizimingiz pulni kichik birliklarda saqlasa, amount_cents ham qabul qilinadi.
| Kanonik tur | Aliaslar | Tavsiya etilgan xossalar | Asosiy ko‘rsatkichlar |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Jalb qilish voronkasi |
activation | activated, user_activated, aha_moment | — | Faollashtirish voronkasi, aha-moment |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Daromad / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, kohort saqlanishi |
subscribe_renewed | subscription_renewed | plan, amount | Takrorlanuvchi daromad |
trial_start | trial_started, free_trial_started | plan, days | Sinovdan to‘lovga o‘tish voronkasi |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Obuna hayot sikli, churn |
upgrade | plan_upgraded | from_plan, to_plan | Kengayishdan tushgan daromad |
downgrade | plan_downgraded | from_plan, to_plan | Daromadning qisqarishi |
share | shared, content_shared | channel | Virallik koeffitsiyenti |
invite | invited, invite_sent, referral_sent | — | K-omil |
Nomlar katta-kichik harf farqisiz moslanadi. Ro‘yxatda YO‘Q aliaslar (masalan, bought, customer_paid) ataylab rad etiladi — taksonomiya jamoalar bo‘ylab barqaror qolishi uchun bitta kanonik shaklga keling.
Eventlar o‘rniga foydalanuvchilarni belgilash. Agar foydalanuvchida doimiy "has purchased" flag’i bo‘lishini istasangiz (faqat per-event signal emas), Kixo.setUserProperty("subscribe", true)ni chaqiring — har bir SDK’dagi "Tag a user for segmentation" bo‘limiga qarang (Web / iOS / Android).
Event tuzilmasi
Kixo’ga yuboriladigan har bir event quyidagi tuzilishga ega:
- event_type — event oilasi, masalan yuqorida ko‘rsatilgan turlar
- event_name — event uchun tavsiflovchi nom
- device_id — qurilmaning noyob identifikatori
- session_id — eventlarni sessiya ichida guruhlaydi
- vaqt belgisi — ISO 8601 vaqt belgisi
- xususiyatlar — qo‘shimcha ma’lumotlar uchun JSON object