Experimentation

incubating

Status of this Document

This report was published by the User Journal Graph Community Group . It is not a W3C Standard nor is it on the W3C Standards Track. Please note that under the W3C Community Contributor License Agreement (CLA) there is a limited opt-out and other conditions apply. Learn more about W3C Community and Business Groups .

Editors: Seva Dolgopolov
Group: User Journal Graph Community Group
Repository: View Source
License: W3C-Software-and-Document

Status: incubating supported extension for experimentation metadata on UJG nodes.

This page provides an exploratory payload shape for experimentation concerns such as experiment keys, variant assignment, activation windows, and kill-switch behavior. The schema and examples below are informative brainstorming material, not normative conformance artifacts.

1. Namespace

Canonical namespace string: https://ujg.specs.openuji.org/ed/extensions/experimentation
Payload location: extensions["https://ujg.specs.openuji.org/ed/extensions/experimentation"]

2. Scope

Applicable UJG objects: Node
Likely attachment points: ExperienceStep, Touchpoint, State

3. Exploratory JSON Schema

json

 {
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://ujg.specs.openuji.org/ed/extensions/experimentation/schema",
  "title": "UJG Experimentation Extension Payload",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "version": { "type": "string" },
    "experimentKey": { "type": "string" },
    "variantKey": { "type": "string" },
    "audiences": {
      "type": "array",
      "items": { "type": "string" }
    },
    "exposureEvent": { "type": "string" },
    "fallbackVariant": { "type": "string" },
    "stickyAssignment": {
      "type": "string",
      "enum": ["none", "session", "user"]
    },
    "activation": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "startAt": { "type": "string", "format": "date-time" },
        "endAt": { "type": "string", "format": "date-time" },
        "killSwitch": { "type": "boolean" }
      }
    }
  },
  "required": ["experimentKey", "variantKey"]
} 
 {
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://ujg.specs.openuji.org/ed/extensions/experimentation/schema",
  "title": "UJG Experimentation Extension Payload",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "version": { "type": "string" },
    "experimentKey": { "type": "string" },
    "variantKey": { "type": "string" },
    "audiences": {
      "type": "array",
      "items": { "type": "string" }
    },
    "exposureEvent": { "type": "string" },
    "fallbackVariant": { "type": "string" },
    "stickyAssignment": {
      "type": "string",
      "enum": ["none", "session", "user"]
    },
    "activation": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "startAt": { "type": "string", "format": "date-time" },
        "endAt": { "type": "string", "format": "date-time" },
        "killSwitch": { "type": "boolean" }
      }
    }
  },
  "required": ["experimentKey", "variantKey"]
} 

4. Example

json

 {
  "@id": "https://example.com/steps/upsell",
  "@type": "ExperienceStep",
  "extensions": {
    "https://ujg.specs.openuji.org/ed/extensions/experimentation": {
      "version": "0.1.0",
      "experimentKey": "upsell-layout-2026-q2",
      "variantKey": "card-grid-b",
      "audiences": ["returning-user", "cart-value-high"],
      "exposureEvent": "upsell_impression",
      "fallbackVariant": "control",
      "stickyAssignment": "session",
      "activation": {
        "startAt": "2026-04-01T00:00:00Z",
        "endAt": "2026-06-30T23:59:59Z",
        "killSwitch": false
      }
    }
  }
} 
 {
  "@id": "https://example.com/steps/upsell",
  "@type": "ExperienceStep",
  "extensions": {
    "https://ujg.specs.openuji.org/ed/extensions/experimentation": {
      "version": "0.1.0",
      "experimentKey": "upsell-layout-2026-q2",
      "variantKey": "card-grid-b",
      "audiences": ["returning-user", "cart-value-high"],
      "exposureEvent": "upsell_impression",
      "fallbackVariant": "control",
      "stickyAssignment": "session",
      "activation": {
        "startAt": "2026-04-01T00:00:00Z",
        "endAt": "2026-06-30T23:59:59Z",
        "killSwitch": false
      }
    }
  }
} 