Core Concepts

Feature Analytics

Bridges the gap between feature delivery and product analysis. Track feature adoption, user cohort performance, and conversion rates directly tied to flag states.

Overview

While standard evaluations only track how many times a flag is served, ToggleAI's Feature Usage Analytics tracks what users actually do once exposed to a feature. It monitors user action telemetry to compute conversion lift, session engagement deltas, and multi-stage funnel behavior for active flags.

Interaction Telemetry Flow

Loading diagram...

Cohort Analysis & Lift

Compare the performance of users who had the feature active (Cohort A) against those who did not (Cohort B) to determine statistical lift.

Metric TypeCohort ON (A)Cohort OFF (B)Delta / Lift
Conversion Rate4.8%4.1%+17.0%
Avg Order Value$45.50$42.00+8.3%
7-Day Retention62%63%-1.5%

SDK Event Integration

Track user interactions with flags by sending events directly from your client SDK using the following methods.

Track Feature Interaction

Report user action details (clicks, views, purchases, custom inputs) tied to a specific flag variation.

typescript
// Track that a user clicked a button rendered by the variant
await client.trackFeatureInteraction({
  flagKey: "new-onboarding-flow",
  flagValue: "variant-b",
  eventType: "click",
  eventName: "onboarding_step_1_click",
  userIdentifier: "user_uuid_101",
  sessionId: "session_abc_999", // optional
  eventMetadata: {
    browser: "Chrome",
    device: "Mobile"
  }
});

Track Feature Interaction Batch

Send multiple interaction events simultaneously to optimize networking and bandwidth.

typescript
// Batch report multiple telemetry interactions
await client.trackFeatureInteractionBatch({
  events: [
    {
      flagKey: "checkout-v2",
      flagValue: "enabled",
      eventType: "view",
      eventName: "checkout_loaded",
      userIdentifier: "user_uuid_101"
    },
    {
      flagKey: "checkout-v2",
      flagValue: "enabled",
      eventType: "purchase",
      eventName: "order_completed",
      eventValue: 129.99, // monetary value
      userIdentifier: "user_uuid_101"
    }
  ]
});