On this page

For AI agents: a documentation index is available at /llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

Experiments Overview

Learn the fundamentals of experimentation with Statsig, including key concepts, randomization units, and statistical significance.

An experiment in Statsig is a randomized controlled trial (an A/B or A/B/n test). Statsig splits users into a control group and one or more test groups, serves each group a different variant, and reports metric lifts with confidence intervals. Use an experiment when you need to know whether a change caused a metric to move. To roll out a change without measuring variant lift, use a feature gate instead.

Experiments banner image

Key concepts

Every experiment you run on Statsig builds on the following concepts.

Control variables

A control variable is the variable in an experiment that you manipulate to observe its effect on key metrics. In a simple A/B test, the control variable has two values (A and B). More complex experiments have more values (for example, A, B, C, and D). Experiments with more than two values are also known as multivariate experiments.

Variants

A variant is a specific version of the product or feature you're testing. For example, in an A/B test:

  • A (Control): The current state of the product or feature.
  • B (Test): The modified state you want to evaluate. This is the single change you're testing.

Statsig randomly assigns users to each variant so you can compare variant performance across equally represented groups.

Statistical significance

Statistical significance determines whether the observed changes in metrics are likely due to the product change or to random variation. Statsig reports two measures:

  • p-value: The probability of observing the results by chance if the variant had no effect. A p-value below 0.05 typically indicates statistical significance.
  • Confidence interval: The range in which the true effect of a variant lies, with a given level of confidence (for example, 95%). If the confidence interval doesn't overlap zero, the effect is statistically significant.

For more information on designing, monitoring, and analyzing experiments, go to Product Experimentation Best Practices.

Choosing the right randomization unit

The randomization unit is the entity, such as a user, device, or session, that Statsig randomly assigns to the control group or a test group. Every value of that unit always receives the same variant. The unit is also the basis of measurement for your metrics. For example, if you set userID as the randomization unit, Statsig deterministically buckets each user by userID, and your analysis reports metrics such as revenue per userID.

Choose the unit that matches where users are in your product when assignment happens. A mismatch causes unintentional crossovers between groups and skews your results. The following table compares the common randomization units.

User identifiers

Your application generates a user ID when a user registers or signs in. Use userID as the randomization unit for experiments on logged-in experiences. For more details on user identifiers in Statsig, go to User Identifiers.

Device identifiers

Statsig generates a stableID, a device identifier unique to Statsig, for each device that interacts with your product. For example, when a guest opens your product on an iOS device, Statsig creates a stableID for that device and tracks the device's actions through it. Use stableID as the randomization unit for experiments on unregistered or guest users, such as landing page changes aimed at improving registration rates. For more details, go to Statsig Guide for Device-Level Experiments.

Session identifiers

Use a session ID as the randomization unit when you test behavior within a single session, such as a guest checkout flow that users typically complete in one visit. Session-based randomization assumes each session is independent of every other session.

Experiment detail tabs

When you open an experiment, its detail page organizes configuration and analysis into the following tabs:

  • Setup: Configure the experiment's scorecard, allocation, targeting, groups, and parameters. Go to Create an Experiment for more details.
  • Diagnostics: View a live log stream of checks and events from your application to confirm your integration works as expected. Go to Monitor an Experiment for more details.
  • Results: Read exposures and scorecard metric lifts. Go to How to Read Experiment Results for more details.
  • Explore: Build custom queries to break down results by user or event dimensions.
  • Summary: Review a high-level summary of the experiment.

Was this helpful?