Events & Funnels

Gurulu automatically detects meaningful user interactions and organizes them into a typed event catalog. Funnels are discovered from observed user flows -- no manual setup required.

Event sources

Events in the catalog come from four sources:

• auto_detected -- clicks, form submissions, scroll milestones captured by the tracker
• user_defined -- custom events you create via CLI, API, or dashboard
• server_verified -- events confirmed by server-side validation
• system_inferred -- events derived by Gurulu AI from behavioral patterns

Defining custom events

You can define events through the dashboard, CLI, or API. Each event definition includes a name, display name, CSS selector or text match, and an optional intent label:

gurulu events define \
  --site-id YOUR_SITE_ID \
  --name add_to_cart \
  --display-name "Add to Cart" \
  --selector "button.add-to-cart" \
  --intent purchase

Supported intents: signup, purchase, lead, subscribe, download, login, onboarding, upgrade.

Auto-discovered funnels

Gurulu analyzes the product flow graph and identifies common multi-step paths that lead to conversion events. These appear as discovered funnels on the Analytics > Funnels page.

Each funnel shows:

• Step-by-step conversion rates
• Drop-off points with volume
• Median time between steps
• Comparison to previous period

Flow graph

The flow graph is a directed graph of state transitions between pages, forms, and actions. It powers funnel discovery and drop-off analysis. View it at Analytics > Flow Graph in the dashboard, or query it via the API:

curl -H "Authorization: Bearer gsk_live_..." \
  "https://gurulu.io/api/analytics/flow-graph?siteId=YOUR_SITE_ID"

Event review

Some auto-detected events may need review. The event catalog shows a "needs review" badge on events that Gurulu is uncertain about. Approving or dismissing them improves future detection accuracy.

For AI-powered analysis of events and funnels, see AI Insights.