A/B Experiments

Record when a user completes a goal action (signup, purchase, etc.) for an experiment. This data is used to calculate statistical significance.

await client.trackConversion({
  experimentId: "exp_xyz",
  variationId: "var_abc",  // from evaluateFlag().variationKey
  metricKey: "signup",
  value: 1.0,              // optional numeric value
  userId: "user_42",
});

Record when a user is exposed to a variation (i.e., they actually saw the experiment variant). This is critical for accurate statistical analysis.

await client.recordExposure({
  experimentId: "exp_xyz",
  variationId: "var_abc",
  userIdentifier: "user_42",
});

Track general metric events that are automatically associated with running experiments. The backend matches events to experiments based on the metricKey.

await client.track({
  metricKey: "purchase_completed",
  userIdentifier: "user_42",
  value: 29.99, // optional numeric value (e.g., revenue)
});

Experiments go through these states:

Backend Endpoints