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

# Analytics Dashboard

> Understand exactly who's clicking your links, where they're coming from, and what's driving performance.

## Overview

Every short link in TyrionURL automatically tracks click events. The Analytics Dashboard transforms those events into charts, maps, and breakdowns that answer the key questions marketers ask: *Who clicked? From where? On what device? When?*

No setup required — analytics begin recording from the moment a link is created.

***

## Accessing Analytics

From your [Dashboard](https://tyrionurl.com/dashboard):

1. Locate the link you want to analyze in your link list
2. Click the link title or the **Analytics** icon (chart icon)
3. The analytics view opens, scoped to that specific link

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/docs-tyrionurl/images/analytics-overview.png" alt="TyrionURL analytics dashboard" />
</Frame>

***

## Analytics Panels

### Click Volume Over Time

A time-series chart showing the number of clicks per time period.

| Time Range    | Available Views                  |
| ------------- | -------------------------------- |
| Last 24 hours | Hourly breakdown                 |
| Last 7 days   | Daily breakdown                  |
| Last 30 days  | Daily breakdown                  |
| Custom range  | TODO: Needs Product Verification |

Use this chart to identify:

* Peak traffic times
* Impact of specific promotional pushes
* Decay rate after a campaign launch

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/docs-tyrionurl/images/analytics-timeseries.png" alt="Click volume over time chart" />
</Frame>

***

### Geographic Distribution

A breakdown of clicks by location, available at:

* **Country level** — pie chart or bar chart of top countries
* **City level** — detailed city-by-city breakdown
* **Heatmap** — visual map with click density overlay

→ Full details: [Geo Heatmaps](/analytics/geo-heatmaps)

***

### Device & Browser Breakdown

Understand the technical profile of your audience:

| Dimension            | Examples                      |
| -------------------- | ----------------------------- |
| **Device Type**      | Mobile, Desktop, Tablet       |
| **Operating System** | iOS, Android, Windows, macOS  |
| **Browser**          | Chrome, Safari, Firefox, Edge |

This data is especially valuable for deciding whether to prioritize mobile-optimized landing pages.

***

### Referrer Sources

See where your traffic is coming from:

| Source Type | Examples                                                |
| ----------- | ------------------------------------------------------- |
| **Social**  | Instagram, Twitter/X, Facebook, LinkedIn                |
| **Email**   | Gmail, Outlook (identified via referrer header)         |
| **Direct**  | No referrer (typed in directly or from a messaging app) |
| **Other**   | Any other identified referrer domain                    |

<Info>
  Some social platforms (notably Instagram) strip referrer headers. Clicks from Instagram's in-app browser may appear as "Direct."
</Info>

***

## Analytics API Endpoints

| Endpoint                                  | Description                             |
| ----------------------------------------- | --------------------------------------- |
| `GET /api/analytics/dashboard/:shortCode` | Full analytics payload for a short link |
| `GET /api/analytics/geo/:shortCode/...`   | Geographic breakdown data               |
| `GET /api/analytics/live/:shortCode`      | Real-time SSE stream of live clicks     |

***

## Best Practices

<Check>Check analytics 24 to 48 hours after launching a campaign — this is when you have enough data to draw early conclusions.</Check>
<Check>Use geographic data to localize follow-up content (e.g., if 60% of clicks came from India, consider regional messaging).</Check>
<Check>Compare device breakdowns to your landing page's mobile conversion rate — a gap signals a mobile UX issue.</Check>
<Check>Set a time-range baseline before comparing two campaigns so you're looking at equivalent windows.</Check>

***

## Related Pages

<CardGroup cols={3}>
  <Card title="Live Traffic" icon="signal" href="/analytics/live-traffic">
    Watch clicks arrive in real time.
  </Card>

  <Card title="Geo Heatmaps" icon="map" href="/analytics/geo-heatmaps">
    Visualize geographic click distribution.
  </Card>

  <Card title="A/B Testing" icon="flask" href="/ab-testing/setup">
    Compare performance across destination variants.
  </Card>
</CardGroup>