Gníomhartha a rianú i gcomhthéacs

Is é an cinneadh ionstraimíochta is tábhachtaí ar fad ná conas a ainmníonn tú imeachtaí agus cá gcuireann tú an comhthéacs. Má fhaigheann tú i gceart é, freagraíonn imeacht amháin dosaen ceist; má fhaigheann tú mícheart é, pléascann do chatalóg ina céadta ainm atá beagnach mar an gcéanna agus nach féidir le tonnadóir ar bith a ailíniú. Is é seo patrún canónach Kixo — an dearadh céanna a mholann comhairleoir ionstraimíochta an AI (suggest_instrumentation sa chomhrá).

An patrún: imeacht ginearálta amháin + airíonna saibhre

Rianaigh imeacht amháin in aghaidh gach gnímh úsáideora agus mínigh an comhthéacs le airíonna — ná scoilt ainm an imeachta de réir comhthéacs riamh. Is é an gníomh céanna (post_opened) atá i bpost a osclaíodh ón gcuardach agus i bpost a osclaíodh ón bhfotha; níl ach airí source difriúil eatarthu.

Frithphatrún

Ná cruthaigh ní mar post_opened_from_search, post_opened_from_feed, post_opened_from_profile. Ciallaíonn trí ainm imeachta trí rud le cothabháil, ní féidir le tonnadóir amháin iad a chuimsiú, agus má chuirtear ceathrú dromchla leis bíonn athrú cóid ag teastáil i ngach áit. Scálann post_opened amháin le source chuig aon líon dromchlaí gan dua.

Ná déan (imeacht in aghaidh an chomhthéacs)	Déan (imeacht amháin + airí)
`post_opened_from_search` `post_opened_from_feed`	`post_opened` le `{ source: "search" \| "feed" }`
`video_played_mobile` `video_played_web`	`video_played` — cuirtear an t-ardán ar gach imeacht go huathoibríoch cheana féin
`checkout_from_cart` `checkout_from_buy_now`	`cart_checked_out` le `{ source: "cart" \| "buy_now" }`

Ainmniú: snake_case (réad)(briathar), aimsir chaite

Ainmnigh gach imeacht mar (object)_(verb) i snake_case, san aimsir chaite — post_opened, video_played, cart_checked_out. Ní mór an t-ainm céanna a úsáid focal ar fhocal ar Web, iOS agus Android ionas go n-ailíníonn tonnadóirí tras-ardáin, agus ionas gur féidir le brathadóir imeachtaí caighdeánacha Kixo na hainmneacha canónacha a mheaitseáil.

An réad ar dtús, an briathar ina dhiaidh — grúpálann sé imeachtaí gaolmhara le chéile agus tú ag scanadh an chatalóige (post_opened, post_liked, post_shared).
An aimsir chaite — taifeadann an t-imeacht rud a tharla.
snake_case — ní postOpened, ní PostOpened. Déantar meaitseáil an bhrathadóra agus an fhoclóra gan aird ar chás, ach coinníonn foirm amháin na tonnadóirí glan.

Airíonna imeachta vs airíonna úsáideora

Is é an leath eile den chinneadh ná cá háit a chónaíonn luach.

	Airí imeachta	Airí úsáideora
Déanann cur síos ar	An tarlú aonair seo den ghníomh	An duine féin, go buan ar fud a imeachtaí uile
Socraítear le	`Kixo.track(name, { ... })`	`Kixo.setUserProperty(key, value)`
Samplaí	`source`, `screen`, `post_id`, `amount_cents`	`plan`, `vip`, `signup_cohort`, `lifetime_orders`
Cumhachtaí	Scagairí tonnadóir in aghaidh na céime, miondealuithe, dáiltí	Deighilt, díriú ar lucht féachana, incháilitheacht feachtais

Leid

Riail ordóige: más féidir leis an luach a bheith éagsúil idir dhá imeacht ón úsáideoir céanna (a post, a foinse), is airí imeachta é. Más fíoras faoin úsáideoir é a fhanann fíor beag beann ar an ngníomh (a bplean, an VIP iad), is airí úsáideora é. Cuir source ar an imeacht; cuir plan ar an úsáideoir.

Tabhair aitheantas cobhsaí aonáin i gcónaí

Seol aitheantas cobhsaí don réad ar bhain an gníomh leis — post_id, video_id, order_id. Gan é sin is féidir leat líon na bpost a osclaíodh a chomhaireamh, ach ní féidir leat imeachtaí faoin bpost céanna céanna a ghrúpáil, a dhídhúbláil ná a shlabhrú. Ní réitíonn tonnadóir ar nós cuardach → oscailt-ón-gcuardach → like go turas úsáideora comhleanúnach ach nuair a iompraíonn gach céim an airí a cheanglaíonn na céimeanna le chéile.

Sampla oibrithe: cuardach → oscailt → like

Abair gur mhaith leat a fháil amach cé mhéad úsáideoir a cuardach, ansin a post a oscailt ó thorthaí cuardaigh, ansin a thaitin leis. Trí imeacht atá i gceist — ach is airí source ar post_opened é an comhthéacs “ón gcuardach”, ní imeacht ar leith:

search_performed — { query }
post_opened — { source: "search", screen, post_id }
post_liked — { source: "search", screen, post_id }

Ansin scagann do thonnadóir céim 2 (agus céim 3) de réir source = "search" — coinníoll amháin ar airí, gan a bheith ag crosbhéimniú ainmneacha imeachtaí. Seo iad na glaonna beachta SDK do gach ardán:

// User runs a search
Kixo.track('search_performed', {
  query: 'running shoes',
});

// User taps a result — the post was opened FROM search
Kixo.track('post_opened', {
  source: 'search',          // ← context as a property, not the event name
  screen: 'search_results',
  post_id: 'post_8f3a1c',
});

// User likes the post they opened from search
Kixo.track('post_liked', {
  source: 'search',
  screen: 'post_detail',
  post_id: 'post_8f3a1c',
});

An t-úsáideoir a chlibeáil ina áit sin

Más tréith bhuan í “thaitin post ón gcuardach leis” ar mhaith leat deighilt a dhéanamh uirthi (seachas comhartha ar imeacht aonair amháin), socraigh airí úsáideora tar éis na gníomhaíochta: Kixo.setUserProperty("liked_from_search", true). Ansin is féidir leis an taiscéalaí lucht féachana agus incháilitheacht feachtais díriú ar na húsáideoirí sin go díreach.

Lig don AI é a dhearadh duit

I gcomhrá dheais Kixo, déan cur síos i ngnáth-Bhéarla ar a bhfuil tú ag iarraidh a thomhas — “track posts opened from search and then liked” — agus tabharfaidh an cúntóir ar ais na himeachtaí molta, na hairíonna agus sleachta cóipeála-greamaithe do na trí ardán. Insíonn agus duit cé na himeachtaí atá ag sreabhadh isteach i do thionscadal cheana agus cad atá fós ag teastáil ón SDK. Is é go díreach an patrún ar an leathanach seo atá i gceist.

Féach freisin: an Tagairt d’imeachtaí do na haon ainm imeachta canónach déag a aithníonn Kixo go huathoibríoch, agus na treoracha SDK de réir ardáin do Web, iOS, agus Android.