Оқиғалар анықтамалығы
Kixo төмендегі кең таралған оқиғаларды автоматты түрде жинайды; нақты құрамы мен жіберілетін дерек пішімі платформаға қарай өзгереді. Барлық оқиғаларда мына стандартты өрістер болады: device_id, session_id, timestamp және properties.
Автоматты жиналатын оқиғалар
| Оқиға түрі | Оқиға атауы | Платформа | Қасиеттер |
|---|---|---|---|
screen_view | Экран атауы | iOS, Android | screen_name, screen_class |
screen_visit | Анықталған экран атауы | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, триггер метадеректері; iOS-та қосымша tap_count және scroll_count болады |
page_view | page_view | Веб | url, path, title, referrer |
tap | Элемент белгісі | iOS, Android | target_class, target_text, screen_name |
click | click | Веб | tag, path, text, href, x, y |
session_start | session_start | Web, iOS, Android | session_id; платформаға тән lifecycle контексі |
session_end | session_end | Web, iOS, Android | session_id; Web-та аяқталу сәтін байқауға болса, duration_ms те қосылады |
scroll_depth | scroll_25 … scroll_100 | Веб | depth (25, 50, 75, 100), url, path |
interaction | rage_click | Веб | tag, path, text, click_count, x, y |
interaction | dead_click | Веб | tag, path, text, x, y |
error | js_error немесе unhandled_rejection | Веб | message, stack, type |
crash | Crash түрі | iOS, Android | message, stack, exception немесе signal контексі |
network | network_request (Web); жиынтық не маршрут белгісі (iOS) | Web-та opt-in, iOS-та opt-in | Тазартылған маршрут, әдіс/статус тобы, ұзақтығы және нәтиже |
performance | Метрика атауы (LCP, FCP, CLS, INP, TTFB) | Веб | value, rating, id, delta |
heatmap_click | heatmap_click | Веб | x, y, viewport_width, viewport_height, page_url, element_selector |
push_received | Push ID | iOS; интеграция жасалса Android/Web | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push ID | Барлығы (Android/Web үшін хост интеграциясы қажет) | 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; Android/Web үшін хост қолданбасымен интеграция | push_id, kixo_campaign_id, interaction_type |
push_action | Push ID | iOS; Android-та хост интеграциясымен | push_id, kixo_campaign_id, action_id |
custom | Оқиға атауы | Барлығы | Сіз беретін кез келген кілт-мән жұбы |
Стандартты оқиғалар (атауы бойынша танылады)
Kixo он бір канондық оқиға атауын таниды. Солардың кез келгенін Kixo.track("purchase", {amount: 49.99, currency: "USD"}) арқылы жіберсеңіз, Kixo қабылдау кезінде оқиғаға standard_kind мәнін қояды. Одан кейін Chat сұраулары, сегменттер мен науқандар standard_kind = 'purchase' деп көрсетіп, барлық баламаны (purchase / purchased / purchase_completed / order_completed / checkout_completed) қолмен тізбестен қамти алады.
Бұл атаулар AI монетизация, конверсия және активация эвристикаларына да қолданылады — Kixo.track("purchase") ешқандай баптаусыз-ақ түсім ретінде танылады; түсім мақсаттарында amount_cents қасиетінің мәні (немесе amount / value) қосылады. Егер жүйеңіз ақшаны ұсақ бірліктермен сақтаса, amount_cents те қабылданады.
| Негізгі түрі | Баламалы атаулар | Ұсынылатын қасиеттер | Мүмкіндіктері |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Тарту воронкасы |
activation | activated, user_activated, aha_moment | — | Белсендіру воронкасы, "aha" сәті |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Түсім / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, когорталық ұстап қалу |
subscribe_renewed | subscription_renewed | plan, amount | Қайталанатын табыс |
trial_start | trial_started, free_trial_started | plan, days | Сынақтан ақылыға өту воронкасы |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Жазылымның өмірлік циклі, кету үлесі |
upgrade | plan_upgraded | from_plan, to_plan | Кеңеюден түсетін табыс |
downgrade | plan_downgraded | from_plan, to_plan | Түсімнің қысқаруы |
share | shared, content_shared | channel | Вирустылық коэффициенті |
invite | invited, invite_sent, referral_sent | — | K-фактор |
Атаулар регистрге тәуелсіз сәйкестендіріледі. Тізімде жоқ балама атаулар (bought, customer_paid сияқты) әдейі қабылданбайды — таксономия командалар арасында тұрақты болуы үшін бір канондық нұсқаға келіңіз.
Оқиғаның орнына пайдаланушыны белгілеу. Пайдаланушыға тұрақты "has purchased" жалаушасы керек болса (тек бір оқиғаға тән сигнал емес), Kixo.setUserProperty("subscribe", true) шақырыңыз — әр SDK-дағы "Tag a user for segmentation" бөлімін қараңыз (Веб / iOS / Android).
Оқиға құрылымы
Kixo-ға жіберілетін әр оқиға мына құрылымға сай болады:
- event_type — оқиға тобы, мысалы жоғарыда көрсетілген түрлер
- event_name — оқиғаның сипаттамалық атауы
- device_id — құрылғының бірегей идентификаторы
- session_id — сессия ішіндегі оқиғаларды топтайды
- уақыт белгісі — ISO 8601 уақыт белгісі
- қасиеттер — қосымша деректері бар JSON объектісі