Custom Events | Tugus Developer Docs

Arbitrary event names outside the standard events, forwarded 1:1 to supported platforms.

Arbitrary event names outside the standard events are allowed. Tugus forwards them 1:1 to all platforms that support custom events:

Meta CAPI: sent as a custom event — appears in Events Manager under "Custom Events"
GA4: forwarded 1:1, visible in GA4 as a custom event (max. 50 custom events per property)
TikTok: sent as a custom event
Pinterest: sent as a custom event
Klaviyo: sent as a generic event with the chosen name
LinkedIn / Bing UET / Google Ads: standard events only, custom events are skipped

Properties are forwarded as well — known fields (value, currency, order_id, contents) are still normalized.

// Chat opened
tugus.track('chat_opened', { widget: 'intercom' })

// Configurator step
tugus.track('configurator_step', {
  step:  2,
  label: 'Choose color',
  value: 'Black',
})

// Newsletter bounce
tugus.track('newsletter_bounce', {
  reason: 'hard_bounce',
  user:   { email: 'invalid@example.com' },
})

Naming convention: Use snake_case for event names — consistent with the standard events. Avoid spaces, special characters, and uppercase letters in event names (Klaviyo is the one exception with its own convention).