ROroblox
Experiments

Calculates the Minimum Detectable Effect (MDE) for a prospective experiment.

Changed on

Poll by clients until the operation is complete.

post/creator-configs-public-api/v1/experimentation/universes/{universeId}/experiments:calculateMde

Request

  • Base URL
    https://apis.roblox.com
  • URL
    https://apis.roblox.com/creator-configs-public-api/v1/experimentation/universes/{universeId}/experiments:calculateMde
  • Auth
    • API key in cookie .ROBLOSECURITY
    • or API key in header x-api-key
    • or OAuth 2
      Authorization code: https://apis.roblox.com/oauth/v1/authorize
      Token URL: https://apis.roblox.com/oauth/v1/token scopes: universe:read

Path parameters

universeIdinteger required

Request body

exposurePercentinteger

Exposure percent in range 0-100. Percent of eligible users seeing the experiment.

durationSecondsinteger

Planned duration of the experiment in whole seconds. Values must be an exact multiple of 86400.

baselineWeightnumber double

Relative weight (in [0, 100]) for the baseline (control) variant.

variantWeightsnumber[] nullable

Relative weights (each in [0, 100]) for each non-baseline variant.

universeGoalMetric'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'

Metric tracked for a universe experiment.

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

Response

OK

Changes

  • bcfdc20689cdRevision changes
    • breaking

      added to the //////////////// request property allOf list (media type: application/json-patch+json)

    • breaking

      added to the //////////////// request property allOf list (media type: application/json)

    • breaking

      added to the //////////////// request property allOf list (media type: text/json)

    • breaking

      added to the //////////////// request property allOf list (media type: application/*+json)

    • breaking

      the ////////////////////////// request property type changed from string to boolean (media type: application/json-patch+json)

    • breaking

      the ////////////////////////// request property type changed from string to boolean (media type: application/json)

    • breaking

      the ////////////////////////// request property type changed from string to boolean (media type: text/json)

    • breaking

      the ////////////////////////// request property type changed from string to boolean (media type: application/*+json)

    • breaking

      the ////////////////////////// request property type changed from string to number, and format from no format to double (media type: application/json-patch+json)

    • breaking

      the ////////////////////////// request property type changed from string to number, and format from no format to double (media type: application/json)

    • breaking

      the ////////////////////////// request property type changed from string to number, and format from no format to double (media type: text/json)

    • breaking

      the ////////////////////////// request property type changed from string to number, and format from no format to double (media type: application/*+json)

    • breaking

      the ////////////////////////// request property type changed from string to integer, and format from no format to int64 (media type: application/json-patch+json)

    • breaking

      the ////////////////////////// request property type changed from string to integer, and format from no format to int64 (media type: application/json)

    • breaking

      the ////////////////////////// request property type changed from string to integer, and format from no format to int64 (media type: text/json)

    • breaking

      the ////////////////////////// request property type changed from string to integer, and format from no format to int64 (media type: application/*+json)

    • breaking

      the //////////////// request property type changed from string to no type (media type: application/json-patch+json)

    • breaking

      the //////////////// request property type changed from string to no type (media type: application/json)

    • breaking

      the //////////////// request property type changed from string to no type (media type: application/*+json)

    • info

      the //////////////// request property type was generalized from string to no type (media type: text/json)

  • 7c6787738100Revision changes
    • warning

      added the new EXPERIMENT_API_ERROR_TYPE_CONFIGS_KEY_HAS_RESERVED_PREFIX enum value to the ////////////// response property for the response status