Skip to content
Documentation menuBusiness roles

Business roles. What an event means, not its name.

A business role is a small, fixed catalogue of meanings mapped to event definitions. The panel, funnels, ads ROAS and conversion destinations read the role, never the event name; renaming a product’s event breaks no screen.

How to map

Open the event in Data › Event schemas and pick it in the Business role field. An app maps its kayit_tamamlandi event to the signup role, for example; the “New sign-ups” card and the sign-up-to-payment funnel work from that role.

The default conversion roles are marked below; an app can change the set.

Roles

RoleNameWhenConversion
signupSign-upThe person opened an account.Default
loginSign-inThe person signed in to their account.
trial_startTrial startA free or discounted trial began.Default
trial_endTrial endThe trial ended without turning into a payment.
activationActivationThe person saw the product’s value for the first time (first project, first order…).
core_actionCore actionThe recurring action that does the product’s main job.
leadLeadA request the sales team will follow up was left.Default
demo_requestDemo requestThe person asked for a demo or a call.Default
contact_clickContact clickA phone, e-mail or messaging link was clicked.
checkout_startCheckout startThe payment step opened.
payment_failedFailed paymentA payment attempt was declined.
purchasePurchaseA payment was received; carries revenue and currency.Default
subscription_renewalSubscription renewalA recurring payment was renewed.
refundRefundPart or all of a payment was returned.
churnChurnA subscription was cancelled or an account closed.
referralReferralThe person recommended the product or sent an invitation.