# Upstream Metrics Schema

Schema for tracking AI platform visibility and engagement metrics.

## Schema Definition

```typescript
interface UpstreamMetrics {
  businessId: string;
  period: DateRange;
  impressions: number;
  citations: number;
  comparisons: number;
  zeroClick: number;
  platforms: PlatformMetrics[];
}
```

## Metrics

* **Impressions**: Times business appeared in AI responses
* **Citations**: Times business was specifically mentioned
* **Comparisons**: Side-by-side comparisons with competitors
* **Zero-Click**: Visibility without clickthrough

## Platform Breakdown

Track metrics per AI platform (Claude, ChatGPT, Perplexity, etc.)