2 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

CalculateExperimentMdeData — openapi

Request body for POST /v1/experimentation/universes/{universeId}/experiments:calculateMde.

Properties

NameTypeRequiredDescription
exposurePercentintegerfalseExposure percent in range 0-100. Percent of eligible users seeing the experiment.
durationSecondsintegerfalsePlanned duration of the experiment in whole seconds. Values must be an exact multiple of 86400.
baselineWeightnumberfalseRelative weight (in [0, 100]) for the baseline (control) variant.
variantWeightsarrayfalseRelative weights (each in [0, 100]) for each non-baseline variant.
universeGoalMetricfalseThe goal metric whose detectable effect is being calculated. UNIVERSE_EXPERIMENT_METRIC_AVERAGE_SESSION_TIME UNIVERSE_EXPERIMENT_METRIC_PLAYTIME_PER_USER UNIVERSE_EXPERIMENT_METRIC_DAY_1_RETENTION UNIVERSE_EXPERIMENT_METRIC_DAY_7_RETENTION UNIVERSE_EXPERIMENT_METRIC_PAYER_CONVERSION_RATE UNIVERSE_EXPERIMENT_METRIC_AVERAGE_REVENUE_PER_USER UNIVERSE_EXPERIMENT_METRIC_AVERAGE_REVENUE_PER_PAYING_USER
targetingCriteriafalseTargeting criteria used to scope the analytics window.

Complete Schema

{
  "type": "object",
  "properties": {
    "exposurePercent": {
      "type": "integer",
      "description": "Exposure percent in range 0-100. Percent of eligible users seeing the experiment.",
      "format": "int32"
    },
    "durationSeconds": {
      "type": "integer",
      "description": "Planned duration of the experiment in whole seconds.\r\nValues must be an exact multiple of `86400`.",
      "format": "int64"
    },
    "baselineWeight": {
      "type": "number",
      "description": "Relative weight (in [0, 100]) for the baseline (control) variant.",
      "format": "double"
    },
    "variantWeights": {
      "type": "array",
      "items": {
        "type": "number",
        "format": "double"
      },
      "description": "Relative weights (each in [0, 100]) for each non-baseline variant.",
      "nullable": true
    },
    "universeGoalMetric": {
      "allOf": [
        {
          "$ref": "#/components/schemas/UniverseExperimentMetric"
        }
      ],
      "description": "The goal metric whose detectable effect is being calculated.\n\nUNIVERSE_EXPERIMENT_METRIC_AVERAGE_SESSION_TIME\n\nUNIVERSE_EXPERIMENT_METRIC_PLAYTIME_PER_USER\n\nUNIVERSE_EXPERIMENT_METRIC_DAY_1_RETENTION\n\nUNIVERSE_EXPERIMENT_METRIC_DAY_7_RETENTION\n\nUNIVERSE_EXPERIMENT_METRIC_PAYER_CONVERSION_RATE\n\nUNIVERSE_EXPERIMENT_METRIC_AVERAGE_REVENUE_PER_USER\n\nUNIVERSE_EXPERIMENT_METRIC_AVERAGE_REVENUE_PER_PAYING_USER",
      "x-enum-varnames": [
        "AverageSessionTime",
        "PlaytimePerUser",
        "Day1Retention",
        "Day7Retention",
        "PayerConversionRate",
        "AverageRevenuePerUser",
        "AverageRevenuePerPayingUser"
      ]
    },
    "targetingCriteria": {
      "allOf": [
        {
          "$ref": "#/components/schemas/TargetingCriteria"
        }
      ],
      "description": "Targeting criteria used to scope the analytics window.",
      "nullable": true
    }
  },
  "additionalProperties": false,
  "description": "Request body for\r\n`POST /v1/experimentation/universes/{universeId}/experiments:calculateMde`."
}