Að rekja aðgerðir í samhengi

Mikilvægasta einstaka ákvörðunin í mælingauppsetningu er hvernig þú nefnir atvik og hvar þú setur samhengi. Geri þú þetta rétt getur eitt atvik svarað tugum spurninga; gerirðu þetta rangt springur skráin út í hundruð næstum eins heita sem engin trekt nær að leggja saman. Þessi leiðarvísir sýnir kanóníska mynstrið í Kixo — sömu hönnun og AI-ráðgjafinn fyrir mælingar (suggest_instrumentation í spjalli) mælir með.

Mynstrið: eitt almennt atvik + ítarlegir eiginleikar

Rekjaðu eitt atvik fyrir hverja notendaaðgerð og lýstu samhenginu með eiginleikar — klofðu aldrei atvikaheitið eftir samhengi. Færsla opnuð úr leit og færsla opnuð úr efnisstraumi eru sama aðgerð (post_opened) með mismunandi source eiginleika.

Gagnmynstur sem ber að forðast

Ekki ekki búa til post_opened_from_search, post_opened_from_feed, post_opened_from_profile. Þrjú atvikaheiti þýða þrjá hluti til að viðhalda, engin ein trekt nær yfir þau öll og þegar fjórði flötur bætist við þarf kóðabreytingu alls staðar. Eitt post_opened með source skalar yfir hvaða fjölda flata sem er án aukavinnu.

Ekki gera þetta (eitt atvik fyrir hvert samhengi)	Gerðu þetta (eitt atvik + eiginleiki)
`post_opened_from_search` `post_opened_from_feed`	`post_opened` með `{ source: "search" \| "feed" }`
`video_played_mobile` `video_played_web`	`video_played` — vettvangur fylgir þegar sjálfkrafa með hverju atviki
`checkout_from_cart` `checkout_from_buy_now`	`cart_checked_out` með `{ source: "cart" \| "buy_now" }`

Nafngift: snake_case, hlutur síðan sögn, í þátíð

Nefndu hvert atvik (object)_(verb) í snake_case og þátíð — post_opened, video_played, cart_checked_out. Sama heiti verður að vera notað orðrétt á Web, iOS og Android svo trektir yfir vettvanga leggist rétt saman og svo staðlaði atvikaneminn í Kixo geti parað við kanónísk heiti.

Hlutur fyrst, sögn á eftir — flokkar skyld atvik saman þegar þú ferð yfir skrána (post_opened, post_liked, post_shared).
Þátíð — atvik skráir eitthvað sem átti sér stað.
snake_case — ekki postOpened, ekki PostOpened. Neminn og heitapörunin eru óháð há- og lágstöfum, en eitt samræmt form heldur trektum hreinum.

Atvikaeiginleikar vs. notendaeiginleikar

Hinn helmingur ákvörðunarinnar er hvar gildið á heima.

	Atvikaeiginleiki	Notendaeiginleiki
Lýsir	Þetta eina tilvik aðgerðarinnar	Notandinn, varanlega þvert á öll atvik hans
Stillt með	`Kixo.track(name, { ... })`	`Kixo.setUserProperty(key, value)`
Dæmi	`source`, `screen`, `post_id`, `amount_cents`	`plan`, `vip`, `signup_cohort`, `lifetime_orders`
Styður	Síur á einstök trektarskref, sundurliðanir, dreifingar	Segmentun, markhópamiðun, hæfi í herferðum

Ábending

Þumalputtaregla: ef gildið getur verið mismunandi milli tveggja atvika frá sama notanda (hvaða færsla, hvaða uppruni) er það atvikaeiginleiki. Ef það er staðreynd um notandann sem gildir óháð aðgerðinni, eins og áskriftarleið eða hvort viðkomandi sé VIP, er það notendaeiginleiki. Settu source á atvikið; settu plan á notandann.

Sendu alltaf stöðugt auðkenni fyrir eininguna

Sendu stöðugt auðkenni fyrir hlutinn sem aðgerðin snerti — post_id, video_id, order_id. Án þess geturðu talið hversu margar færslur voru opnaðar, en þú getur ekki flokkað, afritað út tvítalningar eða tengt saman atvik um sömu sömu færsluna. Trekt eins og leit → opna-úr-leit → líka verður aðeins samhangandi notendaferð þegar hvert skref ber eiginleikann sem tengir skrefin saman.

Dæmi í framkvæmd: leit → opna → líka

Segjum að þú viljir vita hversu margir notendur leit, síðan opna færslu úr leitarniðurstöðum, síðan líka við hana. Þetta eru þrjú atvik — en samhengi eins og „úr leit“ er source eiginleiki á post_opened, ekki sér atvik:

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

Þá síar trektin skref 2, og einnig skref 3, eftir source = "search" — eitt skilyrði á eiginleika, ekkert vesen með atvikaheiti. Hér eru nákvæmu SDK-köllin fyrir hvern vettvang:

// 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',
});

Að merkja notandann í staðinn

Ef „hefur líkað við færslu úr leit“ er varanlegur eiginleiki sem þú vilt geta segmentað eftir, en ekki bara merki á einstöku atviki, skaltu setja notendaeiginleika eftir aðgerðina: Kixo.setUserProperty("liked_from_search", true). Þá geta markhópayfirlitið og hæfi í herferðum miðað beint á þá notendur.

Láttu AI hanna þetta fyrir þig

Í spjallinu í Kixo-mælaborðinu geturðu lýst því sem þú vilt mæla á venjulegu máli — „track posts opened from search and then liked“ — og aðstoðarmaðurinn skilar ráðlögðum atvikum, eiginleikum og kóðabútum sem má afrita beint fyrir alla þrjá vettvanga. og segir þér líka hvaða atvik eru þegar farin að berast fyrir verkefnið þitt og hvað krefst enn SDK-vinnu. Það fylgir nákvæmlega mynstrinu á þessari síðu.

Sjá einnig: Yfirlit yfir atburði fyrir þau ellefu kanónísku atvikaheiti sem Kixo þekkir sjálfkrafa, og SDK-leiðbeiningarnar fyrir Web, iOS og Android.