Etkinlik referansı
Kixo, aşağıdaki yaygın olayları otomatik olarak toplar; tam liste ve aktarım biçimi platforma göre değişir. Tüm olaylarda şu standart alanlar bulunur: device_id, session_id, timestamp ve properties.
Otomatik toplanan olaylar
| Olay türü | Olay adı | Platform | Özellikler |
|---|---|---|---|
screen_view | Ekran adı | iOS, Android | screen_name, screen_class |
screen_visit | Çözümlenen ekran adı | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, tetikleyici meta verileri; iOS için ayrıca tap_count ve scroll_count |
page_view | page_view | Web | url, path, title, referrer |
tap | Öğe etiketi | 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; platforma özgü yaşam döngüsü bağlamı |
session_end | session_end | Web, iOS, Android | session_id; Web, bitiş gözlemlenebiliyorsa duration_ms alanını da içerir |
scroll_depth | scroll_25 … scroll_100 | Web | derinlik (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 veya unhandled_rejection | Web | mesaj, yığın, tür |
crash | Çökme türü | iOS, Android | mesaj, yığın, istisna veya sinyal bağlamı |
network | network_request (Web); toplu veya rota etiketi (iOS) | Web izni, iOS izni | Temizlenmiş rota, yöntem/durum ailesi, süre ve sonuç |
performance | Metrik adı (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 kimliği | iOS; entegre edildiğinde Android/Web | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push kimliği | Tümü (Android/Web için ana uygulama entegrasyonu gerekir) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | Push kimliği | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | Push kimliği | iOS; ana uygulama entegrasyonuyla Android/Web | push_id, kixo_campaign_id, interaction_type |
push_action | Push kimliği | iOS; ana uygulama entegrasyonuyla Android | push_id, kixo_campaign_id, action_id |
custom | Olay adınız | Tümü | Sağladığınız tüm anahtar/değer çiftleri |
Standart olaylar (ada göre tanınır)
Kixo, on bir kanonik olay adını tanır. Bunlardan herhangi birini Kixo.track("purchase", {amount: 49.99, currency: "USD"}) üzerinden izlerseniz Kixo, alım sırasında olaya standard_kind ekler. Böylece Chat sorguları, segmentler ve kampanyalar standard_kind = 'purchase' diyerek tüm eş adları (purchase / purchased / purchase_completed / order_completed / checkout_completed) tek tek yazmadan kapsayabilir.
Bu adlar, AI için gelir / dönüşüm / aktivasyon sezgilerini de besler — Kixo.track("purchase"), hiçbir ek yapılandırma olmadan gelir olarak anlaşılır; gelir hedeflerinde isteğe bağlı amount_cents (veya amount / value) özelliği toplanır. Sisteminiz parayı alt birimlerde tutuyorsa amount_cents da kabul edilir.
| Kanonik tür | Takma adlar | Önerilen özellikler | Kapsam |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Edinme hunisi |
activation | activated, user_activated, aha_moment | — | Aktivasyon hunisi, aha anı |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Gelir / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, kohort elde tutma |
subscribe_renewed | subscription_renewed | plan, amount | Tekrarlayan gelir |
trial_start | trial_started, free_trial_started | plan, days | Deneme-dönüşüm hunisi |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Abonelik yaşam döngüsü, müşteri kaybı |
upgrade | plan_upgraded | from_plan, to_plan | Genişleme geliri |
downgrade | plan_downgraded | from_plan, to_plan | Gelir daralması |
share | shared, content_shared | channel | Viralite katsayısı |
invite | invited, invite_sent, referral_sent | — | K katsayısı |
Adlar büyük/küçük harf farkı gözetmeden eşleştirilir. Listede olmayan eş adlar (ör. bought, customer_paid) bilinçli olarak reddedilir — sınıflandırmanın ekipler arasında tutarlı kalması için tek bir kanonik biçimde birleşin.
Olaylar yerine kullanıcıları etiketlemek. Kullanıcı üzerinde kalıcı bir "satın aldı" işareti istiyorsanız (yalnızca olay bazlı bir sinyal değil), Kixo.setUserProperty("subscribe", true) çağrın — her SDK’nin "Tag a user for segmentation" bölümüne bakın (Web / iOS / Android).
Olay yapısı
Kixo’ya gönderilen her olay şu yapıyı izler:
- event_type — yukarıda gösterilen türler gibi olay ailesi
- event_name — olay için açıklayıcı bir ad
- device_id — benzersiz cihaz tanımlayıcısı
- session_id — olayları bir oturum içinde gruplar
- zaman damgası — ISO 8601 zaman damgası
- özellikler — ek verileri içeren JSON nesnesi