> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gentrackr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracking Visibility

> Learn how to monitor and interpret your app's AI visibility metrics

## Your Visibility Dashboard

The GenTrackr dashboard provides real-time insights into how AI platforms are discovering and recommending your mobile app.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/fbappstudio/images/dashboard-preview.png" alt="GenTrackr Dashboard" style={{maxWidth: '100%', marginBottom: '20px'}} />

## Key Metrics Explained

### Visibility Score

<Card title="What it measures" icon="eye">
  The percentage of relevant queries where your app is mentioned by AI platforms.
</Card>

**How it's calculated**:

```
Visibility Score = (Queries mentioning your app / Total relevant queries) × 100
```

**Example**:

* We run 1,000 queries relevant to meditation apps
* Your app appears in 450 responses
* Your Visibility Score = 45%

<AccordionGroup>
  <Accordion title="What's a good score?">
    - **Below 20%**: Low visibility, significant optimization needed
    - **20-40%**: Average visibility, room for improvement
    - **40-60%**: Good visibility, competitive positioning
    - **Above 60%**: Excellent visibility, market leader status

    Note: Scores vary by category. Niche apps may have lower scores but higher conversion.
  </Accordion>

  <Accordion title="Why does it fluctuate?">
    Your visibility score changes based on:

    * AI model updates and retraining
    * New competitors entering the market
    * Changes to your App Store listing
    * Recent media coverage and reviews
    * Seasonal trends in user queries
  </Accordion>
</AccordionGroup>

### Sentiment Score

<Card title="What it measures" icon="heart">
  How positively AI platforms describe your app when they mention it.
</Card>

**Sentiment Analysis**:

* **90-100**: Highly positive recommendations
* **70-89**: Positive with some caveats
* **50-69**: Neutral or balanced mentions
* **Below 50**: Negative or critical mentions

**Example Responses**:

<CodeGroup>
  ```text Positive (95) theme={null}
  "Headspace is an excellent meditation app with beautifully designed
  guided sessions. Users love its beginner-friendly approach and the
  variety of meditation topics available."
  ```

  ```text Neutral (65) theme={null}
  "Headspace offers guided meditations but requires a subscription.
  It's well-designed though some users find it expensive compared
  to free alternatives."
  ```

  ```text Negative (40) theme={null}
  "While Headspace has quality content, many users complain about
  the high subscription cost and limited free features."
  ```
</CodeGroup>

<Note>
  Improving sentiment often requires addressing issues mentioned in App Store reviews, as AI models reference these in their training.
</Note>

### Average Ranking Position

<Card title="What it measures" icon="ranking-star">
  Where your app typically appears when AI platforms list multiple recommendations.
</Card>

**Position Breakdown**:

* **Position 1-2**: Top recommendation, highest click-through
* **Position 3-5**: Strong mention, good visibility
* **Position 6+**: Lower visibility, users may not notice

**Why it matters**:
Users asking AI for recommendations typically only try the first 2-3 apps mentioned. Improving your ranking position can significantly increase downloads.

<Tip>
  Track which queries result in better ranking positions. These are your "winning" use cases to emphasize in your App Store description.
</Tip>

## Platform Breakdown

### Per-Platform Performance

Your dashboard shows visibility across each AI platform:

<Tabs>
  <Tab title="ChatGPT">
    **Tracking**:

    * GPT-4 responses
    * GPT-4 Turbo responses
    * Web browsing mode vs standard mode

    **Metrics**:

    * Daily mention count
    * Position in recommendations
    * Features highlighted
  </Tab>

  <Tab title="Claude">
    **Tracking**:

    * Claude 3 Opus
    * Claude 3 Sonnet
    * Claude 3 Haiku

    **Metrics**:

    * Mention frequency
    * Reasoning depth
    * Privacy/ethical highlights
  </Tab>

  <Tab title="Perplexity">
    **Tracking**:

    * Standard search results
    * Citation frequency
    * Source diversity

    **Metrics**:

    * Real-time mentions
    * App Store citations
    * News/blog references
  </Tab>

  <Tab title="Gemini">
    **Tracking**:

    * Gemini Pro responses
    * Play Store integration
    * Google ecosystem mentions

    **Metrics**:

    * Android vs iOS mentions
    * Google service integration
    * YouTube content references
  </Tab>
</Tabs>

### Platform Comparison Chart

The dashboard includes a distribution chart showing:

* Percentage of mentions per platform
* Trend changes over time
* Platform-specific opportunities

**Example Insights**:

* "ChatGPT drives 45% of your mentions but Perplexity only 10%"
* "Claude mentions increased 25% this week"
* "Gemini heavily favors your Android version"

## Trend Analysis

### Time-Based Tracking

<Steps>
  <Step title="Daily Trends">
    Monitor day-to-day fluctuations to catch sudden changes.

    **Common patterns**:

    * Weekday vs weekend variations
    * Response to app updates
    * Impact of media coverage
  </Step>

  <Step title="Weekly Trends">
    See broader patterns and seasonal effects.

    **Track**:

    * Week-over-week growth
    * Feature launch impact
    * Competitor activity effects
  </Step>

  <Step title="Monthly Trends">
    Understand long-term visibility trajectory.

    **Analyze**:

    * Overall growth rate
    * Seasonal patterns
    * Major model updates impact
  </Step>
</Steps>

### Trend Indicators

The dashboard uses color-coded indicators:

| Indicator        | Meaning          | Action                                   |
| ---------------- | ---------------- | ---------------------------------------- |
| 🟢 +15% or more  | Strong growth    | Identify what's working, double down     |
| 🟡 +5% to +14%   | Positive trend   | Continue current strategy                |
| ⚪ -4% to +4%     | Stable           | Look for optimization opportunities      |
| 🟠 -5% to -14%   | Declining        | Review recent changes, check competitors |
| 🔴 -15% or worse | Significant drop | Urgent investigation needed              |

## Query Performance

### Top Performing Queries

See which user questions most frequently mention your app.

**Example for a meditation app**:

1. "best meditation app for beginners" - 87% mention rate
2. "apps to reduce anxiety" - 72% mention rate
3. "meditation timer app recommendations" - 65% mention rate
4. "compare headspace vs calm" - 45% mention rate
5. "free meditation apps" - 23% mention rate

<Tip>
  Optimize your App Store description to include keywords from high-performing queries where you're already mentioned.
</Tip>

### Opportunity Gaps

Queries where competitors appear but your app doesn't.

**Example gaps**:

* "sleep meditation apps" - Calm appears 90%, you appear 12%
* "meditation for kids" - Headspace appears 85%, you appear 5%
* "workplace stress apps" - Competitors dominate, you're rarely mentioned

<Note>
  Focus optimization efforts on closing 2-3 key gaps at a time rather than trying to improve everywhere at once.
</Note>

## Filtering and Segmentation

### Available Filters

<AccordionGroup>
  <Accordion title="Date Range">
    * Last 7 days
    * Last 30 days
    * Last 90 days
    * Custom date range
    * Compare periods (e.g., this month vs last month)
  </Accordion>

  <Accordion title="Platform">
    * All platforms
    * ChatGPT only
    * Claude only
    * Perplexity only
    * Gemini only
    * Multiple platform comparison
  </Accordion>

  <Accordion title="Query Type">
    * Feature-based queries
    * Use case queries
    * Comparison queries
    * Category exploration
    * Brand mentions
  </Accordion>

  <Accordion title="Sentiment">
    * All mentions
    * Positive only
    * Neutral only
    * Negative only
  </Accordion>
</AccordionGroup>

### Segmentation Strategies

**By User Intent**:

* Research queries ("what is the best...")
* Comparison queries ("X vs Y")
* Problem-solving ("help with...")
* Feature discovery ("app that does...")

**By Competition Level**:

* Dominant queries (you rank #1-2)
* Competitive queries (you rank #3-5)
* Opportunity queries (competitors rank higher)
* Unclaimed queries (no clear leader)

## Exporting Data

### Export Options

<CardGroup cols={2}>
  <Card title="CSV Export" icon="file-csv">
    Download raw data for analysis in Excel or Google Sheets

    **Includes**:

    * Timestamp
    * Platform
    * Query text
    * Mention status
    * Ranking position
    * Sentiment score
  </Card>

  <Card title="PDF Report" icon="file-pdf">
    Generate formatted reports for stakeholders

    **Includes**:

    * Executive summary
    * Key metrics
    * Trend charts
    * Competitive analysis
  </Card>
</CardGroup>

### Report Scheduling

<Info>
  **Pro and Studio plans** can schedule automated reports:

  * Daily email summaries
  * Weekly performance reports
  * Monthly trend analysis
  * Custom alert thresholds
</Info>

## Setting Up Alerts

### Alert Types

Configure notifications for important changes:

<AccordionGroup>
  <Accordion title="Visibility Alerts">
    Get notified when visibility score:

    * Increases by X%
    * Decreases by X%
    * Crosses a threshold (e.g., drops below 30%)
    * Reaches a new high
  </Accordion>

  <Accordion title="Sentiment Alerts">
    Alert when sentiment:

    * Drops significantly
    * Goes negative
    * Improves substantially
  </Accordion>

  <Accordion title="Competitor Alerts">
    Track when competitors:

    * Launch new features
    * Get mentioned more frequently
    * Appear in your key queries
  </Accordion>

  <Accordion title="New Query Alerts">
    Discover emerging trends:

    * New high-volume queries
    * Trending topics in your category
    * Seasonal pattern changes
  </Accordion>
</AccordionGroup>

### Alert Delivery

* **Email**: Daily digest or real-time
* **Slack**: Integration with your team workspace
* **Dashboard**: In-app notification center
* **API**: Webhook for custom integrations (Studio plan)

## Understanding Historical Data

### Data Retention by Plan

| Plan    | Detailed Data | Aggregate Data |
| ------- | ------------- | -------------- |
| Starter | 30 days       | 90 days        |
| Pro     | 180 days      | 365 days       |
| Studio  | Unlimited     | Unlimited      |

### Historical Analysis Features

<Steps>
  <Step title="Baseline Comparison">
    Compare current performance to your historical baseline.

    **Example**: "Your visibility is 15% higher than your 90-day average"
  </Step>

  <Step title="Event Correlation">
    Match visibility changes to events:

    * App updates and releases
    * Marketing campaigns
    * Media coverage
    * Competitor launches
  </Step>

  <Step title="Seasonal Patterns">
    Identify recurring patterns:

    * Holiday season effects
    * Back-to-school trends
    * New year resolution spikes
    * Summer slowdowns
  </Step>
</Steps>

## Dashboard Best Practices

### Daily Monitoring

<Check>
  **Quick daily check (5 minutes)**:

  1. Review visibility score trend (up/down?)
  2. Check for any alerts or anomalies
  3. Scan top performing queries
  4. Note any significant sentiment changes
</Check>

### Weekly Analysis

<Check>
  **Deep dive (30 minutes weekly)**:

  1. Compare week-over-week trends
  2. Analyze platform-specific performance
  3. Review opportunity gaps
  4. Update optimization strategy
  5. Export data for team review
</Check>

### Monthly Reporting

<Check>
  **Comprehensive review (1-2 hours monthly)**:

  1. Generate executive summary report
  2. Analyze competitive positioning
  3. Review sentiment trends
  4. Plan next month's optimization focus
  5. Share insights with marketing team
</Check>

## Troubleshooting Common Issues

### "My visibility score is 0%"

<Warning>
  Possible causes:

  * Your app was just added (data still collecting)
  * App name spelling mismatch
  * Category targeting too narrow
  * App not yet in AI training data

  **Solution**: Wait 24-48 hours for initial data. Contact support if score remains 0%.
</Warning>

### "Sudden visibility drop"

<Steps>
  <Step title="Check for AI model updates">
    Major platforms regularly update their models. Check our [AI Platforms](/essentials/ai-platforms) page for recent updates.
  </Step>

  <Step title="Review App Store changes">
    Did you recently update your app name, description, or category? These changes affect AI mentions.
  </Step>

  <Step title="Analyze competitor activity">
    Check if competitors launched major updates or marketing campaigns.
  </Step>

  <Step title="Look for negative reviews">
    Recent negative App Store reviews can impact AI sentiment and mention frequency.
  </Step>
</Steps>

### "Data seems inconsistent"

AI platforms can show variation due to:

* Model temperature (randomness in responses)
* Query phrasing variations
* Real-time web search results (Perplexity, Gemini)
* A/B testing by AI platforms

This is normal. Focus on weekly/monthly trends rather than daily fluctuations.

## Next Steps

<CardGroup cols={2}>
  <Card title="Competitor Analysis" icon="users" href="/essentials/competitor-analysis">
    Learn to benchmark against your competition
  </Card>

  <Card title="Optimization Tips" icon="lightbulb" href="/essentials/optimization-tips">
    Strategies to improve your AI visibility
  </Card>
</CardGroup>