Analytics

Fly Super includes built-in analytics powered by Tinybird, providing real-time insights into your landing pages, forms, and visitor behavior. Track performance, measure conversions, and make data-driven decisions.

Overview

Analytics are integrated directly into Fly Super using Tinybird, a high-performance analytics platform that provides:

• Real-time tracking: Events processed in near real-time (< 1 minute delay)
• Privacy-focused: GDPR and CCPA compliant data collection
• Lightweight: Minimal impact on page load times
• Comprehensive: Page views, sessions, sources, devices, locations, and more

What's Tracked

Page Analytics

Track performance of your published landing pages:

Traffic Metrics:

• Page views (total and unique)
• Visitors and sessions
• Current active visitors
• Traffic sources (referrers)
• Geographic locations
• Device and browser breakdown

Performance Metrics:

• Web Vitals (LCP, FID, CLS, TTFB, INP, FCP)
• Performance distribution across routes
• Real-time performance monitoring

Session Tracking

Understanding visitor behavior:

• Session duration
• Pages per session
• Visitor sources (where they came from)
• Session timestamps

Source Attribution

Know where your traffic comes from:

• Top referrers
• Direct traffic
• Source breakdown
• UTM parameter tracking (when used)

Analytics Endpoints

Tinybird provides 10+ API endpoints for querying analytics data:

Core Endpoints

Traffic & KPIs

• analytics_hits - All page view events with full details
• kpis - Key performance indicators (visits, pageviews, bounce rate)
• trend - Traffic trends over time
• current_visitors - Real-time active visitor count

Top Charts

• top_pages - Most viewed pages
• top_sources - Top traffic sources
• top_browsers - Browser distribution
• top_devices - Device type breakdown
• top_locations - Geographic distribution

Domain Analytics

• domain - Domain-specific analytics

Web Vitals Endpoints

Performance Monitoring

• web_vitals_current - Current web vitals metrics
• web_vitals_distribution - Performance score distribution
• web_vitals_routes - Web vitals by route/page

Data Structure

Datasources

Primary Datasource:

• analytics_events - Main event stream capturing all page views and interactions

Materialized Views:

• analytics_pages_mv - Aggregated page-level metrics
• analytics_sessions_mv - Session-level aggregations
• analytics_sources_mv - Source attribution data

These materialized views enable fast queries for dashboard displays.

Web Vitals Tracking

Fly Super automatically tracks Core Web Vitals for all published landing pages:

Metrics Tracked:

• LCP (Largest Contentful Paint) - Loading performance
• FID (First Input Delay) - Interactivity (legacy)
• INP (Interaction to Next Paint) - Interactivity (new)
• CLS (Cumulative Layout Shift) - Visual stability
• TTFB (Time to First Byte) - Server response time
• FCP (First Contentful Paint) - Initial render time

All web vitals are stored in analytics_events with action=web_vital.

How Analytics Are Collected

Automatic Tracking

When visitors view your published landing pages:

1. Lightweight tracking script loads on the page (minimal performance impact)
2. Page view events are sent to Tinybird
3. Session tracking identifies unique visitors
4. Web vitals are automatically measured and reported
5. Data is processed in near real-time
6. Available via API within seconds

Privacy & Compliance

Privacy-Focused:

• No personally identifiable information (PII) collected without consent
• GDPR and CCPA compliant
• IP addresses are not stored permanently
• Respects Do Not Track signals

Data Retention:

• Events stored according to your Tinybird plan
• Configurable retention policies
• Data can be exported or deleted on request

Accessing Analytics Data

Via Tinybird Console

If you have a Tinybird API key configured:

1. Log into Tinybird Console
2. Navigate to your workspace
3. Query datasources and endpoints
4. Build custom dashboards

Via API

Use Tinybird API endpoints to query analytics:

# Example: Get KPIs
curl "https://api.tinybird.co/v0/pipes/kpis.json" \
  -H "Authorization: Bearer YOUR_TINYBIRD_TOKEN"

# Example: Get top pages
curl "https://api.tinybird.co/v0/pipes/top_pages.json" \
  -H "Authorization: Bearer YOUR_TINYBIRD_TOKEN"

# Example: Get current visitors
curl "https://api.tinybird.co/v0/pipes/current_visitors.json" \
  -H "Authorization: Bearer YOUR_TINYBIRD_TOKEN"

Future: Built-in Dashboard

Coming Soon: A native analytics dashboard directly in Fly Super where you can:

• View all metrics without leaving the app
• Filter by landing page, date range, domain
• Compare performance across pages
• Track conversion funnels
• Export reports

Until then, use Tinybird Console or API to access your analytics data.

Configuration

Setting Up Tinybird (Optional)

Analytics are pre-configured if you've added TINYBIRD_API_KEY to your environment variables. If you want to customize:

1. Sign up for Tinybird: tinybird.co
2. Get API token: From Tinybird Console → Tokens
3. Add to environment: Set TINYBIRD_API_KEY in .env.local
4. Deploy datasources: Run tb push in /tinybird directory (if needed)

UTM Parameter Tracking

Enhance analytics with campaign tracking:

Add UTM parameters to your links:

https://yourdomain.com/landing-page?utm_source=facebook&utm_medium=cpc&utm_campaign=spring_2024&utm_content=variant_a

Track campaigns:

• UTM parameters are automatically captured
• Query analytics_events to filter by campaign
• Measure ROI by comparing UTM sources

Use Cases

1. Monitor Landing Page Performance

Goal: See which pages get the most traffic

How: Query top_pages endpoint

• View page paths
• See total views
• Identify top performers

2. Track Traffic Sources

Goal: Know where visitors come from

How: Query top_sources endpoint

• See referrer domains
• Identify top channels (social, search, direct)
• Optimize marketing spend

3. Measure Web Performance

Goal: Ensure pages load fast

How: Query web_vitals_routes endpoint

• View Core Web Vitals per page
• Identify slow pages
• Optimize for better UX

4. A/B Test Analysis

Goal: Compare variant performance

How: Use UTM parameters + analytics_events

• Add ?utm_content=variant_a to Variant A
• Add ?utm_content=variant_b to Variant B
• Query events filtered by UTM content
• Compare conversion rates

5. Geographic Insights

Goal: Understand visitor locations

How: Query top_locations endpoint

• See country/city distribution
• Optimize for target regions
• Adjust content for locales

Limitations & Future Enhancements

Current Limitations

• No built-in dashboard (use Tinybird Console or API)
• Form-specific analytics not yet integrated (track via form submissions dashboard)
• A/B test stats not calculated automatically (manual analysis needed)
• Custom event tracking requires manual implementation

Planned Enhancements

Native Dashboard (Q2 2025)

• View analytics directly in Fly Super
• No need to access Tinybird Console
• Integrated with landing pages and forms
• One-click insights

Form Analytics

• Track submission rates per page
• Identify drop-off points
• Field-level analytics
• Conversion funnels

A/B Test Results

• Automatic variant comparison
• Statistical significance calculation
• Winner recommendation
• Lift calculation

Custom Events

• Track button clicks
• Video plays
• Modal opens
• Scroll depth
• File downloads

Alternative Analytics Solutions

While Tinybird analytics are available, you can also integrate third-party tools:

Google Analytics

Add GA4 to your landing pages:

Manual Setup:

1. Add Google Analytics tracking code via custom JavaScript
2. Contact support for assistance with integration

Track with UTM parameters:

https://yourdomain.com/page?utm_source=google&utm_medium=cpc

Other Tools

Compatible with:

• Mixpanel - Event-based analytics and funnels
• Amplitude - Product analytics
• Plausible - Privacy-friendly analytics
• Fathom - Simple, privacy-focused analytics

Integration: Via custom JavaScript snippets (contact support for help).

Troubleshooting

Analytics Not Showing Data

Possible causes:

1. Tinybird API key not configured - Check TINYBIRD_API_KEY in environment variables
2. Pages not published - Only published pages send analytics events
3. Tracking script blocked - Ad blockers may prevent tracking
4. Recent deployment - Wait a few minutes for events to process

Solutions:

• Verify environment variables are set
• Ensure pages are published and accessible
• Test in incognito mode (no ad blockers)
• Check Tinybird Console for incoming events

Missing Web Vitals

Possible causes:

• Browser doesn't support all vitals (older browsers)
• Page hasn't fully loaded yet
• Network issues during tracking

Solutions:

• Test in modern browsers (Chrome, Firefox, Safari)
• Wait for full page load
• Check browser console for errors

What's Next?

Now that you understand analytics, explore:

• Landing Pages - Create optimized pages
• Forms - Build lead capture forms
• Links - Set up A/B tests with tracking
• Domains - Connect custom domains for tracking

Questions?

Need help with analytics?

• Documentation: Review Tinybird docs at tinybird.co/docs
• GitHub Issues: Report problems or ask questions
• User Guides: See sidebar for comprehensive guides

Want custom analytics?

• Custom endpoints: Tinybird supports custom pipes and datasources
• Advanced setup: Review Tinybird documentation for custom analytics