{
  "version": "2026-09-18",
  "name": "AI Visibility + Knowledge Operations KPI Schema",
  "kpis": [
    {
      "id": "gsc_clicks",
      "source": "GSC",
      "definition": "Organic clicks in measurement window."
    },
    {
      "id": "gsc_impressions",
      "source": "GSC",
      "definition": "Organic impressions in measurement window."
    },
    {
      "id": "priority_query_top20_share",
      "source": "GSC",
      "definition": "Share of priority queries ranking in positions 1-20."
    },
    {
      "id": "ai_citation_rate",
      "source": "Direct AI observation log",
      "definition": "Cited observations / total tested observations."
    },
    {
      "id": "ai_mention_rate",
      "source": "Direct AI observation log",
      "definition": "Mentioned observations / total tested observations."
    },
    {
      "id": "correct_canonical_citation_rate",
      "source": "Direct AI observation log",
      "definition": "Citations pointing to intended canonical URL / total site citations."
    },
    {
      "id": "open_gap_count",
      "source": "Phase 17 queue",
      "definition": "Open remediation items."
    },
    {
      "id": "high_priority_gap_age",
      "source": "Phase 17 queue",
      "definition": "Age of highest-priority unresolved gaps."
    },
    {
      "id": "freshness_compliance",
      "source": "Freshness queue",
      "definition": "Share of tracked time-sensitive objects reviewed before next-review date."
    },
    {
      "id": "duplicate_intent_count",
      "source": "Phase 14",
      "definition": "Confirmed duplicate/cannibalizing intent groups."
    }
  ],
  "interpretation_rules": {
    "do_not_infer_ai_citation_from_gsc": true,
    "brand_mention_not_equal_citation": true,
    "ranking_improvement_not_equal_conversion": true,
    "new_page_count_is_not_a_success_metric": true
  }
}