Semust Metrik
Custom Events
Send your own events with semustMetrik.track() — naming rules and limits.
semustMetrik.track() records things that happen on your site under names you choose — a form submission, a video play, a filter being used. The event is queued when you call it and sent shortly afterwards.
Product page: Semust Metrik.
Usage
semustMetrik.track("video_played", {
video: "intro",
seconds: 42,
completed: true
});The first argument is the event name; the second is an optional set of properties.
Naming rules
| Rule | Value |
|---|---|
| Maximum length | 32 characters |
| Allowed characters | a-z, A-Z, 0-9, _, :, - |
| Other characters | Removed silently |
Keep event names short
Names longer than 32 characters are stored without a name — the event still counts, but
you lose which event it was. Accented and non-Latin characters are also stripped, so
ödeme_başladı becomes deme_balad. Use plain ASCII letters.
Properties
| Rule | Value |
|---|---|
| Maximum properties | 10 |
| Text value length | 255 characters |
| Supported types | Text, numbers, true / false |
| Unsupported types | Arrays and nested objects — skipped silently |
// Works
semustMetrik.track("filter_used", { category: "shoes", price_max: 500 });
// products is an array, so it is not recorded
semustMetrik.track("cart", { products: ["a", "b"] });
// Flatten it instead
semustMetrik.track("cart", { product_count: 2, first_product: "a" });Where your events appear
Custom events are not broken out by name
The Events card in the dashboard counts events by type, so everything you send
with track() is combined into a single "custom_event" row. track("signup") and
track("video_played") do not appear as separate lines.
If you want reporting by name, use goals or Fast Goals — both list conversions by name and calculate a conversion rate.
To inspect individual events, open a session on the Sessions tab; each session lists its events in order.
Calling before the script loads
If your page code can run before the script is ready, queue your calls — see Framework guides.
Monthly allowance
Custom events count against your monthly event allowance. Track usage on the Settings tab; once the allowance is spent, new events are not recorded.