{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/slideforge-dev/json-schema/slideforge-dev-attribution-request-schema.json",
  "title": "AttributionRequest",
  "description": "Where a web signup came from, captured in the browser on first touch.\n\nDeliberately not a URL and not a query string: `landing_path` is the path only and\n`referrer_host` the hostname only, so nothing a search engine or a user put in a query\ncan arrive here. UTM values are the five standard ones, length-capped.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/slideforge-dev-events-api-openapi.yml#/components/schemas/AttributionRequest",
  "properties": {
    "landing_path": {
      "type": "string",
      "maxLength": 200,
      "title": "Landing Path"
    },
    "referrer_host": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 120
        },
        {
          "type": "null"
        }
      ],
      "title": "Referrer Host"
    },
    "utm_source": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ],
      "title": "Utm Source"
    },
    "utm_medium": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ],
      "title": "Utm Medium"
    },
    "utm_campaign": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 120
        },
        {
          "type": "null"
        }
      ],
      "title": "Utm Campaign"
    },
    "utm_term": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 120
        },
        {
          "type": "null"
        }
      ],
      "title": "Utm Term"
    },
    "utm_content": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 120
        },
        {
          "type": "null"
        }
      ],
      "title": "Utm Content"
    },
    "gclid": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "title": "Gclid"
    }
  },
  "type": "object",
  "required": [
    "landing_path"
  ]
}