WysLeap
Documentation

Onboarding Guide

Get from zero to live analytics in minutes — installation, custom events, SaaS metrics, AI observability, and session replay.

SaaS / PLG Tracking

For SaaS companies: Track product-led growth metrics like Time to First Value (TTFV), activation rate, Product Qualified Leads (PQLs), trial conversion, and churn risk.

Why Track PLG Events?

Measure Activation

Track time from signup to "aha moment"

Identify PQLs

Auto-score users showing buying intent (85+ = high intent)

Track Conversion

Monitor free-to-paid and trial-to-paid rates

Predict Churn

Get early warnings when users show disengagement

Client instrumentation

Use WysLeap.trackEvent(eventName, eventData) in your app. Event names and payloads below match what the SaaS/PLG dashboard expects for TTFV, activation, PQL, conversion, and Feature Usage.

1. Signup

When a user creates an account.

html
WysLeap.trackEvent('signup', {
  signupSource: 'organic'       // or 'direct', 'paid', 'referral' (auto-derived from referrer/UTM if omitted)
  signupMethod: 'email'          // or 'google', 'github', 'sso'
});

2. Onboarding (optional)

Improves activation and TTFV accuracy.

html
WysLeap.trackEvent('onboarding_start');
// … when user completes onboarding …
WysLeap.trackEvent('onboarding_complete');

3. Activation & Aha moment

Fire when the user reaches your product's "activation" (e.g. first report, first project). Use activation or aha_moment.

html
WysLeap.trackEvent('activation', {
  activationMilestone: 'first_report_created'
});
// or
WysLeap.trackEvent('aha_moment', { activationMilestone: 'first_export' });

4. Trial start & conversion

html
WysLeap.trackEvent('trial_start', {
  trialPlanTier: 'pro',
  trialDuration: 14
});
WysLeap.trackEvent('trial_converted', {
  planTier: 'pro',
  billingCycle: 'monthly',
  mrr: 99
});

5. Feature usage

Fire when the user uses a product feature (e.g. opens a key screen or completes a key action). Use a stable featureName per feature. Optional featureCategory: core, advanced, analytics, or integration. Powers the Feature Usage table and Power User / Underutilized views.

html
WysLeap.trackEvent('feature_used', {
  featureName: 'advanced_reporting',
  featureCategory: 'advanced'
});

6. Team collaboration

html
WysLeap.trackEvent('team_member_invited');
WysLeap.trackEvent('team_member_joined');

7. Login (for engagement & churn)

Fire on successful login to improve engagement and churn risk metrics.

html
WysLeap.trackEvent('login');

8. Churn signals (optional)

For churn risk and cancellation analytics.

html
WysLeap.trackEvent('cancellation_flow_started');
WysLeap.trackEvent('cancellation_completed');

Event names quick reference

PLG lifecycle:

signup · onboarding_start · onboarding_complete · activation · aha_moment · trial_start · trial_converted · upgrade

Feature & team:

feature_used (eventData: featureName, featureCategory) · team_member_invited · team_member_joined

Engagement & churn:

login · logout · cancellation_flow_started · cancellation_completed

View Your PLG Metrics

Once you've added these events, navigate to Analytics → SaaS / PLG to see:

  • Time to First Value (TTFV) with benchmarks
  • Activation rate and trends
  • Product Qualified Leads with scores
  • Trial conversion rates
  • Churn risk scores with at-risk users
  • PLG funnel visualization
  • Feature Usage — adoption, trend, and correlation with retention/conversion (from feature_used events)

Additional Resources

Building an AI Product?

Learn how to track AI quality, task completion, and user satisfaction with AI Observability.

Next: AI Observability