Gertaeren erreferentzia
Kixo-k beheko ohiko gertaerak automatikoki biltzen ditu; multzo zehatza eta bidalketa-formatua plataformaren arabera aldatzen dira. Gertaera guztiek eremu estandar hauek dituzte: device_id, session_id, timestamp eta properties.
Automatikoki bildutako gertaerak
| Gertaera mota | Gertaeraren izena | Plataforma | Propietateak |
|---|---|---|---|
screen_view | Pantaila-izena | iOS, Android | screen_name, screen_class |
screen_visit | Ebatzitako pantaila-izena | iOS, Android | screen_id, screen_name, visit_id, entry_index, entered_at, exited_at, dwell_ms, exit_reason, trigger metadata; iOS-en, gainera, tap_count eta scroll_count ere sartzen dira |
page_view | page_view | Web | url, path, title, referrer |
tap | Elementuaren etiketa | 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; plataformaren araberako bizi-zikloaren testuingurua |
session_end | session_end | Web, iOS, Android | session_id; Web-ek duration_ms ere jasotzen du amaiera behagarria denean |
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 edo unhandled_rejection | Web | message, stack, type |
crash | Kraskadura mota | iOS, Android | message, stack, exception edo signal testuingurua |
network | network_request (Web); agregatu edo ibilbide-etiketa (iOS) | Web baimena, iOS baimena | Ibilbide garbitua, metodoaren/egoeraren familia, iraupena eta emaitza |
performance | Metrikaren izena (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 IDa | iOS; Android/Web integratuta daudenean | push_id, kixo_campaign_id, app_state, content_hash |
push_open | Push IDa | Guztiak (Android/Web-en host integrazioa behar da) | push_id, kixo_campaign_id, time_to_open_ms, interaction_type |
push_silent | Push IDa | iOS, Android | push_id, kixo_campaign_id, content_hash |
push_dismissed | Push IDa | iOS; Android/Web ostalariaren integrazioarekin | push_id, kixo_campaign_id, interaction_type |
push_action | Push IDa | iOS; Android host integrazioarekin | push_id, kixo_campaign_id, action_id |
custom | Zure gertaera-izena | Guztiak | Ematen dituzun edozein gako-balio bikote |
Gertaera estandarrak (izenaren arabera ezagutzen direnak)
Kixo-k hamaika gertaera-izen kanoniko ezagutzen ditu. Horietako edozein Kixo.track("purchase", {amount: 49.99, currency: "USD"}) bidez erregistratzen baduzu, Kixo-k standard_kind eransten dio gertaerari ingestan. Ondoren, Chat-eko kontsultek, segmentuek eta kanpainek standard_kind = 'purchase' erabil dezakete, eta alias guztiak hartuko dituzte (purchase / purchased / purchase_completed / order_completed / checkout_completed) eskuz zerrendatu beharrik gabe.
Izen hauek AI-ren monetizazio-, bihurketa- eta aktibazio-heuristikak ere elikatzen dituzte: Kixo.track("purchase") diru-sarrera gisa ulertzen da konfiguraziorik gabe; aukerako amount_cents propietatea (edo amount / value) batu egiten da diru-sarreren helburuetarako. Zure sistemak dirua unitate txikietan gordetzen badu, amount_cents ere onartzen da.
| Mota kanonikoa | Aliasak | Gomendatutako propietateak | Elikatzen du |
|---|---|---|---|
signup | sign_up, signed_up, signup_completed, sign_up_completed, account_created, user_registered | — | Eskuratze-funnela |
activation | activated, user_activated, aha_moment | — | Aktibazio-funnela, aha unea |
purchase | purchased, purchase_completed, order_completed, order_placed, checkout_completed | amount, currency | Diru-sarrerak / ARPU |
subscribe_start | subscribe_started, subscription_started | plan, amount, currency, interval | MRR, kohorteen atxikipena |
subscribe_renewed | subscription_renewed | plan, amount | Diru-sarrera errepikakorrak |
trial_start | trial_started, free_trial_started | plan, days | Trial-conversion inbutua |
cancel | cancelled, subscription_cancelled, subscription_canceled | plan | Harpidetzaren bizi-zikloa, churn-a |
upgrade | plan_upgraded | from_plan, to_plan | Hedapeneko diru-sarrerak |
downgrade | plan_downgraded | from_plan, to_plan | Diru-sarreren konpresioa |
share | shared, content_shared | channel | Biralitate-koefizientea |
invite | invited, invite_sent, referral_sent | — | K faktorea |
Izenak maiuskulak eta minuskulak bereizi gabe parekatzen dira. Zerrendan EZ dauden aliasak (adib. bought, customer_paid) nahita baztertzen dira; erabili forma kanoniko bakarra, taxonomia taldeen artean egonkor mantentzeko.
Gertaeren ordez erabiltzaileak etiketatzea. Erabiltzailearentzat "has purchased" bandera iraunkor bat nahi baduzu, eta ez gertaera bakoitzeko seinale hutsa, deitu Kixo.setUserProperty("subscribe", true). Ikusi SDK bakoitzeko "Tag a user for segmentation" atala (Web / iOS / Android).
Gertaeraren egitura
Kixo-ra bidaltzen den gertaera orok egitura hau du:
- event_type — gertaeraren familia, goian erakutsitako moten modukoa
- event_name — gertaeraren izen deskribatzailea
- device_id — gailuaren identifikatzaile bakarra
- session_id — saio bereko gertaerak multzokatzen ditu
- denbora-zigilua — ISO 8601 denbora-zigilua
- propietateak — datu osagarriak dituen JSON objektua