Randomization units

Overview

This topic explains what randomization units are and how to use them in LaunchDarkly Experimentation. An experiment’s randomization unit is the context kind the experiment uses to assign traffic to each of its variations.

When you create an experiment, you will choose a randomization unit that determines both:

• which context kind the experiment will allocate traffic to different variations by, and
• which metrics you can use in the experiment.

Most experiments use the user randomization unit. This means that the experiment will sort contexts that encounter the experiment into different variations by user. You can also choose a different context kind, like device or organization.

Randomization units in metrics and experiments

To use a particular metric within an experiment, the metric and the experiment must use the same context kind as their randomization unit.

You select a metric’s randomization unit when you create it:

Later, when you create an experiment, select the same randomization unit to make the metric available to the experiment:

Like experiments, many metrics use a context kind of user as their randomization unit, but can also use other kinds depending on what the metric is measuring. To learn more, read Creating and managing metrics.

Mark context kinds available for experiments

New context kinds that you create in the LaunchDarkly user interface (UI) are available for experiments by default. You can mark a context kind as available or unavailable for experiments from the Contexts list.

To make a context kind as available or unavailable for experiments:

1. Navigate to the Contexts list.
2. Click the gear icon on the right. The context kinds list appears.
3. Click the three-dot overflow menu next to the context kind you want to edit.
4. Select Edit. The “Edit context kind” dialog appears.
5. Check or uncheck the Available for experiments and guarded rollouts checkbox.
6. (Optional) Check the Set as the default for experiments checkbox if you want new experiments to default to this context kind as the randomization unit.
7. Click Save.

Randomization units and multi-contexts

If you use multi-contexts, you have options as to which context kind you want to use as a randomization unit for an experiment. Expand the section below to view an example.

1
{
2
  "kind": "multi",
3
  "user": {
4
    "key": "user-key-anna", // Anna has a unique user key
5
    "name": "Anna",
6
  },
7
  "organization": {
8
    "key": "org-key-global-health", // The org key is the same in both multi-contexts
9
    "name": "Global Health Services",
10
  }
11
}
12
13
{
14
  "kind": "multi",
15
  "user": {
16
    "key": "user-key-jesse", // Jesse has a unique user key
17
    "name": "Jesse",
18
  },
19
  "organization": {
20
    "key": "org-key-global-health", // The org key is the same in both multi-contexts
21
    "name": "Global Health Services",
22
  }
23
}