{
  "product": "Domain and category trends",
  "synthetic": true,
  "version": "1.0",
  "fields": [
    {
      "name": "period_start",
      "type": "date",
      "nullable": false,
      "definition": "Start of the aggregate reporting period.",
      "example": "2026-07-06",
      "source_alignment": "Derived",
      "production_note": "Synthetic weekly period."
    },
    {
      "name": "market",
      "type": "string",
      "nullable": false,
      "definition": "Approved geographic market.",
      "example": "US",
      "source_alignment": "Derived from CountryCode",
      "production_note": "No person-level geography."
    },
    {
      "name": "category",
      "type": "string",
      "nullable": false,
      "definition": "Normalized market category.",
      "example": "consumer_electronics",
      "source_alignment": "Taxonomy",
      "production_note": "Taxonomy is documented per delivery."
    },
    {
      "name": "domain",
      "type": "string",
      "nullable": false,
      "definition": "Normalized destination domain.",
      "example": "retail.example",
      "source_alignment": "TargetUrl",
      "production_note": "Reserved example domain in sample."
    },
    {
      "name": "visits_index",
      "type": "double",
      "nullable": false,
      "definition": "Indexed synthetic visit level where the baseline leader equals 100.",
      "example": 100,
      "source_alignment": "Calculated",
      "production_note": "Index values are not traffic estimates."
    },
    {
      "name": "unique_cohort_index",
      "type": "double",
      "nullable": false,
      "definition": "Indexed synthetic cohort reach.",
      "example": 100,
      "source_alignment": "Calculated",
      "production_note": "Index values are not panel estimates."
    },
    {
      "name": "referral_share",
      "type": "double",
      "nullable": false,
      "definition": "Synthetic share of visits attributed to referral sources.",
      "example": 0.31,
      "source_alignment": "Calculated",
      "production_note": "Shares use illustrative values."
    },
    {
      "name": "ai_referral_share",
      "type": "double",
      "nullable": false,
      "definition": "Synthetic share of visits attributed to approved AI referral classes.",
      "example": 0.04,
      "source_alignment": "Calculated",
      "production_note": "No raw prompt text."
    },
    {
      "name": "direct_share",
      "type": "double",
      "nullable": false,
      "definition": "Synthetic share attributed to direct traffic.",
      "example": 0.22,
      "source_alignment": "Calculated",
      "production_note": "Channel taxonomy is configurable."
    },
    {
      "name": "search_share",
      "type": "double",
      "nullable": false,
      "definition": "Synthetic share attributed to search traffic.",
      "example": 0.28,
      "source_alignment": "Calculated",
      "production_note": "Channel taxonomy is configurable."
    },
    {
      "name": "week_over_week_change",
      "type": "double",
      "nullable": true,
      "definition": "Synthetic change in visits_index from the prior period.",
      "example": 0.068,
      "source_alignment": "Calculated",
      "production_note": "Null for a first observed period."
    },
    {
      "name": "rank_in_category",
      "type": "int32",
      "nullable": false,
      "definition": "Synthetic rank within market and category.",
      "example": 1,
      "source_alignment": "Calculated",
      "production_note": "Rank is sample-only."
    },
    {
      "name": "device_class",
      "type": "string",
      "nullable": false,
      "definition": "Broad device scope.",
      "example": "all",
      "source_alignment": "Derived from UserAgent",
      "production_note": "Can be filtered to a broad device class."
    },
    {
      "name": "aggregation_window",
      "type": "string",
      "nullable": false,
      "definition": "Window used for aggregation.",
      "example": "7d",
      "source_alignment": "Product setting",
      "production_note": "Configurable."
    },
    {
      "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."
    }
  ]
}