{
  "product": "AI search signals",
  "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": "ai_platform_class",
      "type": "string",
      "nullable": false,
      "definition": "Normalized AI discovery surface class.",
      "example": "conversational",
      "source_alignment": "Derived from ReferrerUrl",
      "production_note": "Platform naming depends on permitted taxonomy."
    },
    {
      "name": "query_topic",
      "type": "string",
      "nullable": false,
      "definition": "Broad aggregated topic category.",
      "example": "consumer_electronics",
      "source_alignment": "Derived aggregate",
      "production_note": "No raw prompt or conversation text."
    },
    {
      "name": "intent_class",
      "type": "string",
      "nullable": false,
      "definition": "Aggregated discovery intent stage.",
      "example": "comparison",
      "source_alignment": "Derived aggregate",
      "production_note": "Model-defined and documented per delivery."
    },
    {
      "name": "source_domain",
      "type": "string",
      "nullable": false,
      "definition": "Normalized referring domain.",
      "example": "assistant.example",
      "source_alignment": "ReferrerUrl",
      "production_note": "Reserved example domain in sample."
    },
    {
      "name": "destination_domain",
      "type": "string",
      "nullable": false,
      "definition": "Normalized visited domain.",
      "example": "retail.example",
      "source_alignment": "TargetUrl",
      "production_note": "Reserved example domain in sample."
    },
    {
      "name": "referral_visits",
      "type": "int64",
      "nullable": false,
      "definition": "Synthetic count of referral visits in the cohort.",
      "example": 18420,
      "source_alignment": "Aggregate",
      "production_note": "Not a BGraph coverage claim."
    },
    {
      "name": "unique_cohort_count",
      "type": "int64",
      "nullable": false,
      "definition": "Synthetic count of distinct approved cohort keys.",
      "example": 4280,
      "source_alignment": "Aggregate",
      "production_note": "Not a user or panel claim."
    },
    {
      "name": "click_through_rate",
      "type": "double",
      "nullable": false,
      "definition": "Synthetic share of eligible AI discovery events followed by a visit.",
      "example": 0.184,
      "source_alignment": "Calculated",
      "production_note": "Definition and denominator require methodology."
    },
    {
      "name": "median_seconds_to_visit",
      "type": "int32",
      "nullable": true,
      "definition": "Synthetic median elapsed seconds from discovery to visit.",
      "example": 94,
      "source_alignment": "Calculated",
      "production_note": "Only available when event ordering is permitted."
    },
    {
      "name": "device_class",
      "type": "string",
      "nullable": false,
      "definition": "Broad device category.",
      "example": "desktop",
      "source_alignment": "Derived from UserAgent",
      "production_note": "No full user agent string."
    },
    {
      "name": "aggregation_window",
      "type": "string",
      "nullable": false,
      "definition": "Window used for aggregation.",
      "example": "7d",
      "source_alignment": "Product setting",
      "production_note": "Configurable."
    },
    {
      "name": "privacy_tier",
      "type": "string",
      "nullable": false,
      "definition": "Illustrative aggregation threshold label.",
      "example": "aggregate_k100",
      "source_alignment": "Product setting",
      "production_note": "Threshold is illustrative, not a production promise."
    },
    {
      "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."
    }
  ]
}