Eseményreferencia
A Kixo automatikusan gyűjti az alábbi gyakori eseményeket; a pontos készlet és az adattovábbítás formátuma platformonként eltérhet. Minden esemény tartalmazza a következő standard mezőket: device_id, session_id, timestamp és properties.
Automatikusan gyűjtött események
| Eseménytípus | Eseménynév | Platform | Tulajdonságok |
|---|---|---|---|
screen_view | Képernyőnév | iOS, Android | screen_name, screen_class |
screen_visit | Feloldott képernyőnév | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, trigger metaadatok; iOS esetén a tap_count és a scroll_count is |
page_view | page_view | Web | url, path, title, referrer |
tap | Elemcímke | 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; platformspecifikus életciklus-kontextus |
session_end | session_end | Web, iOS, Android | session_id; Weben a duration_ms is, ha a befejezés megfigyelhető |
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 vagy unhandled_rejection | Web | üzenet, verem, típus |
crash | Az összeomlás típusa | iOS, Android | üzenet, verem, kivétel- vagy szignálkontextus |
network | network_request (Web); összesítő vagy útvonalcímke (iOS) | Webes opt-in, iOS-opt-in | Szűrt útvonal, metódus-/státuszkategória, időtartam és kimenet |
performance | Metrika neve (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-azonosító | iOS; Android/Web integráció esetén | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push-azonosító | Összes (Android/Web esetén host oldali integráció szükséges) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | Push-azonosító | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | Push-azonosító | iOS; Android/Web hosztoldali integrációval | push_id, kixo_campaign_id, interaction_type |
push_action | Push-azonosító | iOS; Android host oldali integrációval | push_id, kixo_campaign_id, action_id |
custom | Saját eseménynév | Összes | Bármely általad megadott kulcs-érték pár |
Standard események (név alapján felismerve)
A Kixo tizenegy kanonikus eseménynevet ismer fel. Ha ezek bármelyikét a Kixo.track("purchase", {amount: 49.99, currency: "USD"}) használatával követed, a Kixo feldolgozáskor hozzáad egy standard_kind mezőt az eseményhez. Ezután a chatlekérdezések, szegmensek és kampányok elég, ha a standard_kind = 'purchase' nevet használják, és kézi felsorolás nélkül lefedik az összes aliast (purchase / purchased / purchase_completed / order_completed / checkout_completed).
Ezek a nevek az AI monetizációs, konverziós és aktivációs heurisztikáit is táplálják — a Kixo.track("purchase") eseményt a rendszer külön beállítás nélkül bevételként értelmezi; az opcionális amount_cents tulajdonságot (vagy amount / value) összeadja a bevételi célokhoz. Ha a rendszered a pénzösszegeket kisebb pénzegységben tárolja, a amount_cents is elfogadott.
| Kanonikus típus | Aliasok | Ajánlott tulajdonságok | Alapja |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Akvizíciós tölcsér |
activation | activated, user_activated, aha_moment | — | Aktivációs tölcsér, aha-pillanat |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Bevétel / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, kohorszmegtartás |
subscribe_renewed | subscription_renewed | plan, amount | Visszatérő bevétel |
trial_start | trial_started, free_trial_started | plan, days | Próbaidőszak–konverziós tölcsér |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Előfizetési életciklus, lemorzsolódás |
upgrade | plan_upgraded | from_plan, to_plan | Bővülési bevétel |
downgrade | plan_downgraded | from_plan, to_plan | Bevételcsökkenés |
share | shared, content_shared | channel | Viralitási együttható |
invite | invited, invite_sent, referral_sent | — | K-faktor |
A neveket a rendszer kis- és nagybetűtől függetlenül egyezteti. A listában NEM szereplő aliasokat (például bought, customer_paid) szándékosan elutasítjuk — használjatok egységesen egy kanonikus alakot, hogy a taxonómia csapatok között is stabil maradjon.
Felhasználók címkézése események helyett. Ha tartós „has purchased” jelölést szeretnél a felhasználóhoz rendelni, nem csak eseményszintű jelzést, hívd meg a(z) Kixo.setUserProperty("subscribe", true) metódust — lásd az egyes SDK-k „Felhasználó megjelölése szegmentáláshoz” szakaszát (Web / iOS / Android).
Esemény szerkezete
A Kixo felé küldött minden esemény ezt a szerkezetet követi:
- event_type — az eseménycsalád, például a fenti típusok egyike
- event_name — az esemény beszédes neve
- device_id — egyedi eszközazonosító
- session_id — egy munkameneten belül csoportosítja az eseményeket
- időbélyeg — ISO 8601 formátumú időbélyeg
- tulajdonságok — további adatokat tartalmazó JSON objektum