# Upstream Metrics

Track your business visibility **before** traditional analytics begin.

## What Are Upstream Metrics?

Traditional analytics (Google Analytics, Yelp Insights) start tracking when someone **clicks** on your business. But what about all the times AI assistants **mention** your business without a click?

**Upstream metrics** capture this invisible visibility:

* 🔍 **Impressions**: AI mentioned your business in a response
* 📝 **Citations**: AI quoted or referenced your business
* ⚖️ **Comparisons**: Your business appeared in side-by-side comparisons
* 👁️ **Zero-Click**: Users saw your business but didn't click (brand awareness)

## Why This Matters

### The AI Discovery Difference

**Traditional Analytics**: Only sees the 1 booking click\
**AIDP Platform**: Sees all 10 mentions + 1 booking = Complete visibility

**With AIDP**: You see all 10 mentions, not just the 1 booking.

### Real Impact

Businesses using upstream metrics see:

* **3x better conversion rates** from AI traffic vs traditional
* **Higher quality leads** (pre-qualified through conversation)
* **Shorter sales cycles** (customers arrive more informed)
* **Better ROI** (understand full visibility, not just clicks)

## Metrics Explained

### Impressions

**What it is**: Your business appeared in an AI response.

**Example**:

```
User: "Coffee shops in Portland with outdoor seating"
AI: "I recommend checking out Artisan Coffee Roasters,
     Blue Star Donuts, and Stumptown Coffee..."

Your business = 1 impression
```

**Why it matters**: Even without a click, the user now knows your business exists. That's brand awareness.

**In your dashboard**:

* Total impressions this month
* Impression context (what AI said about you)
* Trend over time
* Impressions per query type

### Citations

**What it is**: AI quoted or specifically referenced your business.

**Example**:

```
User: "Tell me more about Artisan Coffee Roasters"
AI: "Artisan Coffee Roasters is known for their single-origin
     beans sourced directly from Colombian farmers. They roast
     small batches twice weekly..."

Your business = 1 citation (primary placement)
```

**Citation Quality**:

* **Primary**: Main focus of response (3x conversion rate)
* **Secondary**: Mentioned alongside others (1.5x conversion rate)
* **Tertiary**: Brief mention (1x baseline conversion rate)

**Why it matters**: Citations indicate strong relevance and build credibility. Primary citations convert at 3x the rate of tertiary citations.

**In your dashboard**:

* Total citations
* Citation placement breakdown
* Citation context
* Citation-to-conversion rate

### Comparisons

**What it is**: Your business appeared in a side-by-side comparison.

**Example**:

```
User: "Compare Artisan Coffee Roasters and Stumptown Coffee"
AI: [Provides detailed comparison table]

Your business = 1 comparison appearance
```

**Tracked data**:

* How many comparisons you appeared in
* Who you were compared against
* Your position in comparisons
* Win rate (when you were recommended)

**Why it matters**: Comparisons indicate high purchase intent. Users are close to deciding.

**In your dashboard**:

* Total comparison appearances
* Most common competitors
* Average position
* Win rate percentage

### Zero-Click Visibility

**What it is**: User saw your business in AI response but didn't click or book.

**Example**:

```
User: "Coffee shops in Portland"
AI: "Artisan Coffee Roasters is highly rated..."
User: "Actually, I'll go to the one closer to me"

Result: You got brand awareness but no click
```

**Why it matters**:

* Brand awareness has value (estimated $0.50-$5 per impression)
* User may return later
* Word-of-mouth potential
* Top-of-mind awareness

**In your dashboard**:

* Zero-click impressions
* Estimated brand awareness value
* Reach (unique users)
* Recall rate (users who return later)

### Share of Voice

**What it is**: Your percentage of total mentions in your category.

**Example**:

```
Coffee shops in Portland mentioned this month:
- Artisan Coffee Roasters: 450 mentions (30%)
- Stumptown Coffee: 600 mentions (40%)
- Blue Star Donuts: 300 mentions (20%)
- Others: 150 mentions (10%)

Your share of voice = 30%
```

**Why it matters**: Indicates competitive positioning and market presence.

**In your dashboard**:

* Your share percentage
* Category average
* Top competitors
* Trend over time

## Understanding Your Dashboard

### Overview Tab

**Key Metrics**:

```
Impressions:     1,247  (+23% vs last month)
Citations:       456    (+15% vs last month)
Comparisons:     89     (+8% vs last month)
Zero-Click:      234    ($1,872 brand value)
Share of Voice:  30%    (+5% vs last month)
```

### Impressions Tab

**What you see**:

* Daily impression count
* Impression context (what AI said)
* Query types that triggered impressions
* Geographic distribution
* AI platform breakdown (Claude, ChatGPT, etc.)

**Example**:

```
Dec 7, 2025 - 42 impressions

Top contexts:
1. "Known for single-origin beans" (12 times)
2. "Outdoor seating available" (8 times)
3. "Locally owned and operated" (6 times)
```

### Citations Tab

**What you see**:

* Citation count by placement quality
* Citation context (full quotes)
* Citation-to-conversion rate
* Most cited content

**Example**:

```
Primary Citations: 123 (27% conversion rate)
Secondary Citations: 234 (12% conversion rate)
Tertiary Citations: 99 (5% conversion rate)

Most cited content:
"We source beans directly from Colombian farmers"
→ Cited 45 times, led to 12 bookings
```

### Comparisons Tab

**What you see**:

* Comparison frequency
* Common competitors
* Your position in comparisons
* Win rate

**Example**:

```
Compared 89 times this month

Most common competitors:
1. Stumptown Coffee (34 comparisons, 65% win rate)
2. Blue Star Donuts (28 comparisons, 71% win rate)
3. Coava Coffee (27 comparisons, 59% win rate)

Average position: 1.8 (out of 3)
Overall win rate: 67%
```

### Zero-Click Tab

**What you see**:

* Zero-click impression count
* Estimated brand awareness value
* Reach and frequency
* Recall rate (users who return)

**Example**:

```
Zero-Click Impressions: 234

Estimated Value: $1,872
(Based on $8 average brand awareness value per impression)

Reach: 15,600 unique users
Recall Rate: 12% (users who returned within 30 days)
```

## How to Improve Your Metrics

### Increase Impressions

✅ **Do**:

* Write detailed, specific descriptions
* Add AI-exclusive content
* Use natural language (not keyword stuffing)
* Keep information current
* Add high-quality photos

❌ **Don't**:

* Copy generic content
* Use marketing jargon
* Leave fields empty
* Let data go stale

### Increase Citations

✅ **Do**:

* Provide unique, quotable content
* Share insider tips and local secrets
* Tell your story authentically
* Highlight what makes you different
* Update exclusive content regularly

❌ **Don't**:

* Use generic descriptions
* Copy from competitors
* Overpromise
* Forget to update

### Win More Comparisons

✅ **Do**:

* Highlight your unique strengths
* Provide clear pricing
* Showcase high ratings
* Emphasize sustainability/values
* Respond to reviews

❌ **Don't**:

* Hide pricing
* Ignore negative reviews
* Neglect profile updates
* Forget exclusive content

### Maximize Zero-Click Value

✅ **Do**:

* Build strong brand identity
* Create memorable taglines
* Share unique stories
* Provide exceptional service (word-of-mouth)
* Stay top-of-mind

❌ **Don't**:

* Blend in with competitors
* Use generic branding
* Neglect brand building
* Forget follow-up

## Advanced Insights

### Quality Over Volume

**Traditional thinking**: "I need more clicks!"

**AI-native thinking**: "I need better visibility!"

**Why**:

* AI traffic converts at **3x the rate** of traditional traffic
* Users arrive more qualified (pre-screened by AI)
* Shorter sales cycles (already researched)
* Higher average order value

**Focus on**:

* Citation quality (primary > secondary > tertiary)
* Comparison win rate (not just appearances)
* Intent strength (high-intent queries)
* Journey efficiency (fewer touchpoints to conversion)

### Conversion Multiplier

Track how AI traffic performs vs traditional:

```
AI Traffic:
- 100 impressions → 15 bookings = 15% conversion rate

Traditional Traffic:
- 100 clicks → 5 bookings = 5% conversion rate

Conversion Multiplier: 3x
```

**If your multiplier is lower**:

* Improve profile quality
* Add more exclusive content
* Optimize pricing clarity
* Respond to reviews faster

### Share of Voice Strategy

**Goal**: Increase your category share

**Tactics**:

1. **Content differentiation**: Stand out with unique content
2. **Verification**: Get certified for trust signals
3. **Review management**: Maintain high ratings
4. **Exclusive offers**: Give AI users special deals
5. **Consistency**: Keep all information current

**Track**:

* Your share percentage
* Top competitor shares
* Category growth
* Your growth rate vs category

## API Access

Access upstream metrics programmatically:

```bash
GET /api/v1/business/analytics/upstream
```

**Parameters**:

```json
{
  "startDate": "2025-11-01",
  "endDate": "2025-11-30",
  "metrics": ["impressions", "citations", "comparisons", "zero_click"]
}
```

**Response**:

```json
{
  "period": { "start": "2025-11-01", "end": "2025-11-30" },
  "impressions": {
    "total": 1247,
    "inSummary": 892,
    "trend": "+23%"
  },
  "citations": {
    "total": 456,
    "primary": 123,
    "secondary": 234,
    "tertiary": 99,
    "trend": "+15%"
  },
  "comparisons": {
    "total": 89,
    "averagePosition": 1.8,
    "winRate": 0.67
  },
  "zeroClick": {
    "impressions": 234,
    "estimatedValue": 1872.5,
    "brandAwarenessReach": 15600
  }
}
```

[View API reference →](https://amistan.gitbook.io/aidp-docs/for-developers/api-reference/analytics)

## FAQs

**Q: Why don't other platforms track this?**\
A: Traditional platforms were built for web search (click-based). AIDP is built for AI discovery (mention-based).

**Q: How accurate is the brand awareness value?**\
A: Based on industry benchmarks for brand impressions. Your actual value may vary based on category and market.

**Q: Can I export this data?**\
A: Yes! Use the API or export from your dashboard (CSV, JSON).

**Q: How often is data updated?**\
A: Real-time for impressions and citations. Aggregated metrics update hourly.

**Q: What's a good impression-to-citation ratio?**\
A: Industry average is 3:1 (3 impressions per citation). Higher is better.

**Q: Should I focus on impressions or citations?**\
A: Both matter, but citations indicate stronger relevance and convert better.

## Next Steps

* [Understand Intent Journeys](https://amistan.gitbook.io/aidp-docs/for-business-owners/analytics/intent-journeys)
* [Learn About Attribution](https://amistan.gitbook.io/aidp-docs/for-business-owners/analytics/attribution)
* [View Competitive Benchmarks](https://amistan.gitbook.io/aidp-docs/for-business-owners/analytics/benchmarking)
* [Optimize Your Content](https://amistan.gitbook.io/aidp-docs/for-business-owners/profile-setup/exclusive-content)

***

**Questions?** Contact <support@aidp.dev> or join our [GitHub Discussions](https://github.com/aidp/platform/discussions)