Даведнік па падзеях
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 | Web | url, path, title, referrer |
tap | Пазнака элемента | 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; кантэкст жыццёвага цыкла, спецыфічны для платформы |
session_end | session_end | Web, iOS, Android | session_id; у Web дадаецца duration_ms, калі канец можна назіраць |
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 або unhandled_rejection | Web | message, stack, type |
crash | Тып збою | iOS, Android | message, stack, кантэкст exception або signal |
network | network_request (Web); агрэгаваная або route-пазнака (iOS) | Web opt-in, iOS opt-in | Ачышчаны маршрут, сямейства method/status, працягласць і вынік |
performance | Назва метрыкі (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; 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-moment |
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 | Варонка канверсіі з trial |
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) — глядзіце раздзел «Tag a user for segmentation» у адпаведным SDK (Web / iOS / Android).
Структура падзеі
Кожная падзея, адпраўленая ў Kixo, мае такую структуру:
- event_type — сямейства падзеі, напрыклад тыпы, паказаныя вышэй
- event_name — апісальная назва падзеі
- device_id — унікальны ідэнтыфікатар прылады
- session_id — групуе падзеі ў межах сесіі
- timestamp — пазнака часу ў фармаце ISO 8601
- properties — JSON object з дадатковымі данымі