v2

latestOpenAPI 3.0.02026-08-073221853.1 MB

Autotunes

Fully Update Autotune

Update all properties of the experiment

post/console/v1/autotunes/{id}

Path parameters

idstring required

Request body

descriptionstring

A brief summary of what the autotune is being used for.

successEventstring required

The event you are trying to optimize for.

successEventValuestring

The value that should come with the event for it to be considered successful.

explorationWindow'1hr' | '24hr' | '48hr' | '168hr' | '336hr' | '1' | '24' | '48' | '168' | '336' | '1hrs' | '24hrs' | '48hrs' | '168hrs' | '336hrs' required

The initial time period where Autotune will equally split the traffic.

attributionWindow'1hr' | '2hr' | '4hr' | '24hr' | '1hrs' | '2hrs' | '4hrs' | '24hrs' | '1' | '2' | '4' | '24' required

The maximum duration between the exposure and success event that counts as a success.

attributionWindowUnit'min' | 'hour' | 'day'

Time unit of attribution window

explorationWindowRatenumber double

Exploration window rate

longtermExplorationAllocationnumber double

Long term exploration allocation

winnerThreshold'80%' | '90%' | '95%' | '98%' | '99%' required

The "probability of best" threshold a variant needs to achieve for Autotune to declare it the winner, stop collecting data, and direct all traffic.

metadataFieldstring

Metadata field containing the numeric value to optimize for. If this field is null, autotune optimizes for the existence of a follow-up event. This is only used for contextual autotunes.

higherIsBetterboolean

Whether to optimize for an increase or decrease in the metadata field value. Default is true. This is only used for contextual autotunes.

isContextualboolean

Whether this is a contextual autotune

metricSourceIDstring

Metric source to pull success event data from

linkedExperimentNamestring

Linked experiment to measure the success of the Autotune

goalRichTextstring

Autotune goal

optimizationParameter'occurrence' | 'value'

Optimize for event occurrence vs value

valueColumnstring

Metric source column to optimize for

featureListstring[]

List of features that should be included in the analysis

Example request

{
  "id": "my_autotunes_are_best",
  "isStarted": false,
  "description": "helpful summary of what this Autotune is",
  "lastModifierID": "ahKwUoaNauHu9AmJPc2",
  "lastModifierName": "CONSOLE API",
  "variants": [
    {
      "name": "red",
      "json": {
        "foo": "boo"
      },
      "size": 50
    },
    {
      "name": "blue",
      "json": {},
      "size": 50
    }
  ],
  "successEvent": "purchase_item",
  "successEventValue": "",
  "explorationWindow": "1hr",
  "attributionWindow": "2hrs",
  "winnerThreshold": "99%",
  "idType": "userID"
}

Response

Fully Update Autotune Success

messagestring required

A simple string explaining the result of the operation.

Example response

{
  "message": "Autotune Experiment read successfully.",
  "data": {
    "id": "my_autotunes_are_best",
    "isStarted": false,
    "description": "helpful summary of what this Autotune is",
    "lastModifierID": "jd93DGSnvkauH9FijdGiajh",
    "lastModifierName": "CONSOLE API",
    "inlineTargetingRulesJSON": "{}",
    "inlineTargetingRules": [],
    "variants": [
      {
        "name": "red",
        "json": {
          "color": "red"
        }
      },
      {
        "name": "blue",
        "json": {
          "color": "blue"
        }
      }
    ],
    "successEvent": "purchase_item",
    "successEventValue": "",
    "explorationWindow": "1hr",
    "attributionWindow": "2hrs",
    "winnerThreshold": "99%"
  }
}