Референца за настани
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; контекст за lifecycle специфичен за платформата |
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 | порака, stack, тип |
crash | Тип на пад | iOS, Android | порака, 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 | Сите (потребна е host интеграција на 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 со интеграција преку host | push_id, kixo_campaign_id, interaction_type |
push_action | Push ID | iOS; Android со host интеграција | push_id, kixo_campaign_id, action_id |
custom | Вашето име на настан | Сите | Сите key-value парови што ќе ги зададете |
Стандардни настани (се препознаваат по име)
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 | Инка за конверзија од пробен период |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Животен циклус на претплата, churn |
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 — ги групира настаните во рамки на сесија
- временска ознака — ISO 8601 временска ознака
- својства — JSON object со дополнителни податоци