Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion insights/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,32 @@

## Metrics

Use the range selector to adjust the time period for displayed data. Select visitors, views, or actions to display a line graph showing trends over the selected time period.
Use the range selector to adjust the time period for displayed data. Select visitors, views, actions, or searches to display a line graph showing trends over the selected time period.

- **Visitors**: Unique visitors
- **Views**: Total page views
- **Actions**: Combined count of API calls, navbar link clicks, and CTA button clicks

Check warning on line 17 in insights/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/overview.mdx#L17

Spell out 'CTA', if it's unfamiliar to the audience.
- **Searches**: Total number of search queries performed in your documentation
- **Popular Pages**: Paths to the most-visited pages and their view counts
- **Referrers**: Top traffic sources directing users to your docs

## Search analytics

Search analytics help you understand what users are looking for in your documentation. The search metrics include:

- **Search query**: The exact terms users searched for
- **Hits**: Number of times the query was searched

Check warning on line 27 in insights/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/overview.mdx#L27

In general, use active voice instead of passive voice ('was searched').
- **CTR**: Click-through rate showing the percentage change compared to the previous period

Check warning on line 28 in insights/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/overview.mdx#L28

Spell out 'CTR', if it's unfamiliar to the audience.
- **Top clicked page**: The most frequently clicked result for each search query
- **Last searched**: Timestamp of the most recent search for that query

Use search analytics to:

- **Identify content gaps**: Discover what users are searching for but may not be finding easily
- **Optimize existing content**: See which pages users click on most frequently for specific queries

Check warning on line 35 in insights/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

insights/overview.mdx#L35

Use 'click' or 'click in' instead of 'click on'.
- **Track search trends**: Monitor changes in search behavior over time to understand evolving user needs
- **Improve discoverability**: Use high-volume search queries to inform your content structure and navigation

## Using overview data

Review your overview analytics to:
Expand Down