PULSE

import { WaveClient } from '@wave/sdk';

const wave = new WaveClient({ apiKey: process.env.WAVE_API_KEY });

// Get real-time stream analytics
const analytics = await wave.pulse.getStreamAnalytics({
  streamId: 'stream_abc123',
  realtime: true
});

console.log('Current viewers:', analytics.viewers.current);
console.log('Peak viewers:', analytics.viewers.peak);
console.log('Avg watch time:', analytics.engagement.avgWatchTime);
console.log('Engagement rate:', analytics.engagement.rate);

// Subscribe to real-time updates
wave.pulse.subscribe('stream_abc123', (update) => {
  console.log('Viewer count:', update.viewers);
  console.log('Bitrate:', update.bitrate);
  console.log('Quality:', update.quality);
});

Track custom business events like button clicks, purchases, and conversions

import { WaveClient } from '@wave/sdk';

import { DesignTokens, getContainer, getSection } from '@/lib/design-tokens';
const wave = new WaveClient({ apiKey: process.env.WAVE_API_KEY });

// Track custom events with properties
await wave.pulse.trackEvent({
  event: 'premium_upgrade_clicked',
  userId: 'user_123',
  properties: {
    plan: 'pro',
    price: 49.99,
    source: 'stream_page',
    trial: false
  },
  timestamp: new Date()
});

// Track conversion events
await wave.pulse.trackConversion({
  event: 'subscription_started',
  userId: 'user_123',
  revenue: 49.99,
  currency: 'USD',
  properties: {
    plan: 'pro',
    billing: 'monthly',
    referral: 'google_ads'
  }
});

// Batch track multiple events
await wave.pulse.trackEvents([
  { event: 'video_watched', userId: 'user_1', properties: { duration: 1200 } },
  { event: 'chat_message_sent', userId: 'user_2', properties: { length: 45 } },
  { event: 'share_clicked', userId: 'user_3', properties: { platform: 'twitter' } }
]);

PULSE analytics have sub-second latency. Viewer counts update within 500ms. Engagement metrics refresh every second. Bandwidth and quality metrics stream in real-time via WebSocket connection. See viewer joins/leaves as they happen. Perfect for live events where you need instant feedback. Historical data is available with millisecond-precision timestamps for detailed analysis.

PULSE tracks 100+ metrics across 4 categories: Audience (viewers, retention, geography, devices), Engagement (interactions, chat, shares, click-through), Performance (bitrate, buffering, errors, latency), and Business (revenue, conversions, CAC, LTV, churn). Custom events let you track anything specific to your application. All metrics are exportable via API or CSV.

Yes, PULSE supports multiple export formats. Download CSV files for spreadsheet analysis. Export to Google Sheets with automatic sync. Use REST API to pull data programmatically. Integrate with data warehouses (Snowflake, BigQuery, Redshift). Set up automated email reports (daily, weekly, monthly). Real-time streaming exports via webhooks for BI tools. All data is yours to use however you need.

Starter plans retain 30 days of detailed analytics with unlimited summary data. Professional plans retain 1 year of full-resolution data. Enterprise plans have unlimited retention with custom retention policies. Archived data remains accessible but moves to cheaper storage. All plans include real-time access to current data. No data is ever deleted without your explicit permission.

Yes, PULSE supports custom event tracking via JavaScript API. Track button clicks, form submissions, purchases, sign-ups, or any user action. Pass custom properties with each event for detailed segmentation. Create custom dashboards and funnels around your events. Perfect for tracking business-specific metrics like conversions or upsells. Events integrate seamlessly with standard PULSE metrics.

Yes, PULSE offers two-way sync with Google Analytics. Send PULSE events to GA4 automatically. Import GA4 conversion data into PULSE. Also supports Mixpanel, Amplitude, and Segment integrations. Use our REST API to connect with any analytics platform. Combine streaming metrics with website analytics for complete picture. Privacy-compliant with GDPR and CCPA regulations.

Absolutely! PULSE allows you to define custom calculated metrics using our formula builder. Combine existing metrics with mathematical operations, create ratios, or define custom business logic. For example, create "Revenue per Concurrent Viewer" by dividing total revenue by peak viewers. Custom metrics appear alongside standard metrics in dashboards and can be used in alerts and reports. Perfect for tracking unique business KPIs specific to your streaming platform.

PULSE dashboards have flexible sharing options. Share via unique URL with customizable permissions (view-only, edit, or admin). Embed dashboards in your internal tools using iframe or JavaScript widget. Schedule automated dashboard snapshots to email or Slack. Export dashboards as PDF reports. Set up role-based access control for team members. Dashboards update in real-time for all viewers. Enterprise plans include SSO integration and advanced permissions.

Concurrent viewers is the number watching at a specific moment in time - it fluctuates constantly throughout your stream. Peak viewers is the maximum concurrent viewer count reached during a stream - the highest point on the concurrent viewer graph. For example, you might have 1,000 concurrent viewers right now, but peaked at 2,500 earlier. Peak viewers is useful for capacity planning and comparing stream performance, while concurrent is essential for real-time monitoring.

Yes, PULSE supports historical data import for migrations and integrations. Upload CSV files with timestamped events to backfill gaps. Import from legacy analytics platforms via API. Historical data maintains full fidelity including all properties and metadata. Backfilled data integrates seamlessly with live data for continuous trend analysis. Useful when migrating from another platform or recovering from data collection issues. Enterprise plans include assisted migration services.

PULSE alerts monitor your metrics 24/7 and notify you when thresholds are crossed. Set conditions like "viewer count drops by 50%" or "error rate exceeds 2%". Choose notification channels: email, SMS, Slack, webhook, or PagerDuty. Configure alert severity levels and escalation policies. Alerts can be time-based (e.g., only during business hours) or conditional (e.g., only alert if event lasts 5+ minutes). Smart alerts use ML to reduce false positives and adapt to your traffic patterns.

Yes, PULSE is fully compliant with GDPR, CCPA, and major privacy regulations. We provide built-in consent management, user opt-out mechanisms, and data deletion tools. All personal data is encrypted at rest and in transit. You can anonymize viewer data while preserving analytical value. Data processing agreements (DPA) available for enterprise customers. Geographic data restrictions to keep EU data in EU servers. Regular third-party privacy audits. You maintain full ownership and control of your analytics data at all times.