Experiment
A structure containing the configuration details of an experiment.
Contents
- arn
-
The ARN of the experiment.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 2048.
Pattern:
arn:[^:]*:[^:]*:[^:]*:[^:]*:project/[-a-zA-Z0-9._]*/experiment/[-a-zA-Z0-9._]*
Required: Yes
- createdTime
-
The date and time that the experiment is first created.
Type: Timestamp
Required: Yes
- lastUpdatedTime
-
The date and time that the experiment was most recently updated.
Type: Timestamp
Required: Yes
- name
-
The name of the experiment.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 127.
Pattern:
^[-a-zA-Z0-9._]*$
Required: Yes
- status
-
The current state of the experiment.
Type: String
Valid Values:
CREATED | UPDATING | RUNNING | COMPLETED | CANCELLED
Required: Yes
- type
-
The type of this experiment. Currently, this value must be
aws.experiment.onlineab
.Type: String
Valid Values:
aws.evidently.onlineab
Required: Yes
- description
-
A description of the experiment.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 160.
Pattern:
.*
Required: No
- execution
-
A structure that contains the date and time that the experiment started and ended.
Type: ExperimentExecution object
Required: No
- metricGoals
-
An array of structures that defines the metrics used for the experiment, and whether a higher or lower value for each metric is the goal.
Type: Array of MetricGoal objects
Array Members: Minimum number of 1 item. Maximum number of 3 items.
Required: No
- onlineAbDefinition
-
A structure that contains the configuration of which variation to use as the "control" version. The "control" version is used for comparison with other variations. This structure also specifies how much experiment traffic is allocated to each variation.
Type: OnlineAbDefinition object
Required: No
- project
-
The name or ARN of the project that contains this experiment.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 2048.
Pattern:
arn:[^:]*:[^:]*:[^:]*:[^:]*:project/[-a-zA-Z0-9._]*
Required: No
- randomizationSalt
-
This value is used when Evidently assigns a particular user session to the experiment. It helps create a randomization ID to determine which variation the user session is served. This randomization ID is a combination of the entity ID and
randomizationSalt
.Type: String
Length Constraints: Minimum length of 0. Maximum length of 127.
Pattern:
.*
Required: No
- samplingRate
-
In thousandths of a percent, the amount of the available audience that is allocated to this experiment. The available audience is the total audience minus the audience that you have allocated to overrides or current launches of this feature.
This is represented in thousandths of a percent, so a value of 10,000 is 10% of the available audience.
Type: Long
Valid Range: Minimum value of 0. Maximum value of 100000.
Required: No
- schedule
-
A structure that contains the time and date that Evidently completed the analysis of the experiment.
Type: ExperimentSchedule object
Required: No
- segment
-
The audience segment being used for the experiment, if a segment is being used.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 2048.
Pattern:
arn:[^:]*:[^:]*:[^:]*:[^:]*:segment/[-a-zA-Z0-9._]*
Required: No
- statusReason
-
If the experiment was stopped, this is the string that was entered by the person who stopped the experiment, to explain why it was stopped.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 160.
Pattern:
.*
Required: No
-
The list of tag keys and values associated with this experiment.
Type: String to string map
Key Length Constraints: Minimum length of 1. Maximum length of 128.
Key Pattern:
^(?!aws:)[a-zA-Z+-=._:/]+$
Value Length Constraints: Minimum length of 0. Maximum length of 256.
Required: No
- treatments
-
An array of structures that describe the configuration of each feature variation used in the experiment.
Type: Array of Treatment objects
Array Members: Minimum number of 2 items. Maximum number of 5 items.
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: