{
  "product": "Clickstream events feed",
  "synthetic": true,
  "version": "1.0",
  "fields": [
    {
      "name": "user_id_hash",
      "type": "string",
      "nullable": false,
      "definition": "Hashed randomized user identifier used to order synthetic events.",
      "example": "c31736d95c95e0894df6cd2edf122bbe9fac92662d6ad275343285b3b1f7d9e0",
      "source_alignment": "UserId",
      "production_note": "Pseudonymous field. Availability and retention require source-rights and jurisdiction review."
    },
    {
      "name": "event_date",
      "type": "date",
      "nullable": false,
      "definition": "UTC event date and delivery partition date.",
      "example": "2026-07-14",
      "source_alignment": "EventDate",
      "production_note": "Production raw delivery may partition files by Year/Month/Day."
    },
    {
      "name": "event_timestamp",
      "type": "timestamp_ms",
      "nullable": false,
      "definition": "UTC event time with millisecond precision.",
      "example": "2026-07-14T08:12:04.118Z",
      "source_alignment": "EventTimestamp",
      "production_note": "Precision may be reduced for privacy or product design."
    },
    {
      "name": "country_code",
      "type": "string",
      "nullable": false,
      "definition": "ISO 3166-1 alpha-2 country code.",
      "example": "US",
      "source_alignment": "CountryCode",
      "production_note": "Country-level coverage is verified during scoping."
    },
    {
      "name": "city",
      "type": "string",
      "nullable": true,
      "definition": "City label when permitted and available.",
      "example": "Exampleville",
      "source_alignment": "City",
      "production_note": "Synthetic placeholder. City may be excluded or generalized."
    },
    {
      "name": "postal_code",
      "type": "string",
      "nullable": true,
      "definition": "Postal code when permitted and available.",
      "example": "00000",
      "source_alignment": "PostalCode",
      "production_note": "Synthetic placeholder. Postal codes may be excluded or generalized."
    },
    {
      "name": "referrer_url",
      "type": "string",
      "nullable": true,
      "definition": "URL that referred the event to target_url.",
      "example": "https://search.example/results",
      "source_alignment": "ReferrerUrl",
      "production_note": "URLs use reserved example domains in this sample."
    },
    {
      "name": "target_url",
      "type": "string",
      "nullable": false,
      "definition": "URL visited by the synthetic user.",
      "example": "https://reviews.example/audio",
      "source_alignment": "TargetUrl",
      "production_note": "URLs use reserved example domains in this sample."
    },
    {
      "name": "user_agent",
      "type": "string",
      "nullable": true,
      "definition": "Software agent associated with the synthetic request.",
      "example": "BGraphSyntheticBrowser/1.0 (Desktop)",
      "source_alignment": "UserAgent",
      "production_note": "May be normalized to a broad device or browser class."
    },
    {
      "name": "http_code",
      "type": "int32",
      "nullable": true,
      "definition": "HTTP response status code when available.",
      "example": 200,
      "source_alignment": "HttpCode",
      "production_note": "Optional source field."
    },
    {
      "name": "is_synthetic",
      "type": "boolean",
      "nullable": false,
      "definition": "Always true in public sample files.",
      "example": true,
      "source_alignment": "Sample-only",
      "production_note": "Not a production field."
    }
  ]
}