Custom events

Track clicks, signups, downloads, purchases, and other custom events with Kobbe.

Track button clicks, form submissions, and other interactions without JavaScript.

Events appear next to pageviews in the dashboard—keep names short and consistent (signups, outbound links, pricing clicks, etc.).

HTML attributes

Add data-kobbe-event to any element. Clicks on that element will be tracked as a custom event.

<button
  type="button"
  data-kobbe-event="Newsletter signup"
  data-kobbe-event-source="footer"
>
  Subscribe
</button>

Event name

The event name. Required.

data-kobbe-event="Newsletter signup"

Event properties

Optional properties sent as key-value pairs. For example, data-kobbe-event-source="footer" sends { source: "footer" }.

data-kobbe-event-source="footer"

Use short, consistent event names. For example, use Newsletter signup everywhere instead of mixing Newsletter signup, newsletter-signup, and Subscribe clicked.

Scroll visibility events

Scroll tracking is off by default and requires tracker.full.js. To track when a visitor reaches an important section, use the full tracker and add data-kobbe-scroll to that element:

<section data-kobbe-scroll="viewed_pricing">
  <h2>Pricing</h2>
</section>

The tracker sends the custom event once when the section becomes visible. Use short, non-personal event names such as viewed_pricing or read_testimonials. See Scroll tracking for thresholds, delays, and GDPR-friendly default guidance.

JavaScript API

The tracker sets window.kobbe. Call .track from your code after the tracker has loaded.

window.kobbe?.track("Purchase completed", { plan: "pro" });

Use the JavaScript API when the event is not a simple click, such as after a payment succeeds, after an API request completes, or after a form validates.

Limits

Constraint	Limit
Event name length	64 characters
Properties per event	16 keys
Property key length	48 characters
Property value length	200 characters

Events or properties that exceed these limits are truncated or dropped by the server.

Examples

Good:

window.kobbe?.track("Signup completed", { plan: "pro" });

Avoid:

window.kobbe?.track("Signup completed", { email: "person@example.com" });