{
  "$defs": {
    "Moderators": {
      "additionalProperties": false,
      "properties": {
        "creative_refresh": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Creative Refresh"
        },
        "peak": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Peak"
        },
        "retargeting_share": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Retargeting Share"
        },
        "self_measured": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Self Measured"
        },
        "spend_intensity": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Spend Intensity"
        }
      },
      "title": "Moderators",
      "type": "object"
    }
  },
  "$id": "https://schemas.ump.dev/v1/benchmark-row.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "description": "One evidence row. ``client_ref`` is salted; client names never enter pooled tables.",
  "properties": {
    "absorbed_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Absorbed By"
    },
    "admissibility_class": {
      "anyOf": [
        {
          "enum": [
            "A",
            "B",
            "C",
            "D",
            "E"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Admissibility Class"
    },
    "approved_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Governance member (spec \u00a76): approver principal.",
      "title": "Governance ApprovedBy"
    },
    "calibrated": {
      "default": false,
      "title": "Calibrated",
      "type": "boolean"
    },
    "channel": {
      "title": "Channel",
      "type": "string"
    },
    "client_ref": {
      "title": "Client Ref",
      "type": "string"
    },
    "confidence_level": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Confidence Level"
    },
    "content_hash": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Governance member (spec \u00a76): the artifact content hash.",
      "title": "Governance ContentHash"
    },
    "estimand_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "E-BM-AVG-ROI, E-BM-MARG-ROI, ... or None.",
      "title": "Estimand Id"
    },
    "feed_cost": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Feed Cost"
    },
    "filed_at": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Filed At"
    },
    "filed_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Principal that filed the row. Written by core `GET /v1/benchmark/evidence` row view (`services/benchmark.py`).",
      "title": "Filed By"
    },
    "gate_results": {
      "anyOf": [
        {
          "items": {},
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Governance member (spec \u00a76): gate results of the latest run.",
      "title": "Governance GateResults"
    },
    "hold_reason": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Hold Reason"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Governance member (spec \u00a76): artifact id.",
      "title": "Governance Id"
    },
    "interval_hi": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Interval Hi"
    },
    "interval_lo": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Interval Lo"
    },
    "is_forecast": {
      "default": false,
      "title": "Is Forecast",
      "type": "boolean"
    },
    "licence": {
      "default": "pooled_use",
      "enum": [
        "pooled_use",
        "client_only"
      ],
      "title": "Licence",
      "type": "string"
    },
    "log_value": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "log iROAS (or log cost per person lifted).",
      "title": "Log Value"
    },
    "metric_family": {
      "default": "sales_return",
      "enum": [
        "sales_return",
        "brand_awareness",
        "ad_recall",
        "consideration",
        "delivery_quality",
        "effectiveness_index"
      ],
      "title": "Metric Family",
      "type": "string"
    },
    "moderators": {
      "$ref": "#/$defs/Moderators"
    },
    "notes": {
      "description": "Note codes.",
      "items": {
        "type": "string"
      },
      "title": "Notes",
      "type": "array"
    },
    "owner": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Governance member (spec \u00a76): owner principal.",
      "title": "Governance Owner"
    },
    "pool_status": {
      "default": "on_file",
      "enum": [
        "pooled",
        "on_file",
        "held_from_pool",
        "decision_score",
        "client_only"
      ],
      "title": "Pool Status",
      "type": "string"
    },
    "quarter": {
      "description": "e.g. 2026 Q2",
      "title": "Quarter",
      "type": "string"
    },
    "refit_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Refit Id"
    },
    "revision": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Governance member (spec \u00a76): content revision (spec \u00a77).",
      "title": "Governance Revision"
    },
    "se": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Se"
    },
    "se_effective": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "SE after every recorded multiplier (`se_multipliers`), the one pooling uses. Written by core `GET /v1/benchmark/evidence` row view (`services/benchmark.py`).",
      "title": "Se Effective"
    },
    "se_multipliers": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "number"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "\u00a725.3 rule 1: every SE multiplier applied to this row (source, age, ...).",
      "title": "Se Multipliers"
    },
    "source_type": {
      "enum": [
        "mmm_meridian",
        "mmm_pymc",
        "redacted_engine",
        "mmm_robyn",
        "mmm_vendor",
        "geo_test",
        "matched_market",
        "platform_conv_lift",
        "platform_ab",
        "vendor_curve",
        "audience_model",
        "scenario_forecast",
        "brand_lift_platform",
        "brand_lift_panel",
        "panel_sales_lift",
        "delivery_quality",
        "brand_tracker",
        "mei_index",
        "mei_kpi_model"
      ],
      "title": "Source Type",
      "type": "string"
    },
    "spend": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Spend"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Governance member (spec \u00a76): lifecycle state of the version.",
      "title": "Governance State"
    },
    "submitted_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Governance member (spec \u00a76): submitter principal.",
      "title": "Governance SubmittedBy"
    },
    "valid_to": {
      "default": null,
      "description": "Governance member (spec \u00a76): end of the validity window (spec \u00a77).",
      "title": "Governance ValidTo"
    },
    "value": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "\u00a725.3 rule 4a: the estimate on its reported scale, kept when non-positive (note NONPOSITIVE_ESTIMATE).",
      "title": "Value"
    },
    "value_basis": {
      "anyOf": [
        {
          "enum": [
            "net",
            "gross"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Value Basis"
    },
    "value_scale": {
      "anyOf": [
        {
          "enum": [
            "identity",
            "log"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Scale of `value`.",
      "title": "Value Scale"
    },
    "vertical": {
      "title": "Vertical",
      "type": "string"
    }
  },
  "required": [
    "client_ref",
    "channel",
    "vertical",
    "quarter",
    "source_type"
  ],
  "title": "BenchmarkEvidence",
  "type": "object"
}