# Google Search Console
The Google Search Console (GSC) integration brings your search performance data directly into VitalSentinel. Track keywords, impressions, clicks, and indexing status alongside your other monitoring data.
## What is Google Search Console? [#what-is-google-search-console]
Google Search Console is a free tool from Google that helps you:
* Monitor search performance
* See which queries bring visitors
* Track indexing status
* Identify search-related issues
## Connecting Google Search Console [#connecting-google-search-console]
### Step 1: Connect Your Google Account [#step-1-connect-your-google-account]
1. Go to your workspace and click **Integrations** in the sidebar
2. Click **Connect Google Account**
3. Sign in with your Google account
4. Grant access to Search Console data
### Step 2: Link to Your Domain [#step-2-link-to-your-domain]
1. Open the domain you want to connect.
2. Click **Google Search Console** in the domain sidebar.
3. From the GSC properties available on your connected account, pick the one to link.
After linking, you can swap or unlink the property from the **Edit** page (sections **Google Analytics Property** and **Google Search Console Property**), each with **Change** and **Remove** actions.
You must have access to the Google Search Console property in your connected Google account for it to appear in the picker. Verify access in GSC first if it's missing.
## Dashboard Overview [#dashboard-overview]
### Key Metrics [#key-metrics]
The GSC dashboard displays four key metrics:
| Metric | Description |
| ----------------- | ------------------------------------------- |
| Total Clicks | Times users clicked your search result |
| Total Impressions | Times your pages appeared in search results |
| Average CTR | Click-through rate (clicks ÷ impressions) |
| Avg Position | Average ranking position in search results |
### Performance Chart [#performance-chart]
View trends over time with an interactive chart showing clicks, impressions, CTR, and position. Use the date range picker to analyze different periods, with a comparison mode to see how metrics changed.
Google Search Console data is delayed by 2 to 3 days, so the most recent data may not be available immediately. In rare cases, the delay can be as long as 10 days.
Data in VitalSentinel may differ from Google Search Console by up to 5% due to sampling and aggregation differences. This variance increases when you apply filters. For exact figures, refer to Google Search Console directly.
### Data Sections [#data-sections]
The dashboard includes four data sections:
**Queries**
* Top Queries tab: Keywords driving the most traffic
* New Queries tab: Recently discovered search terms
* Shows clicks, impressions, CTR, and position per query
**Pages**
* Top Pages tab: Best performing pages in search
* New Pages tab: Pages recently appearing in search results
* Shows clicks, impressions, CTR, and position per page
**Countries**
* Geographic breakdown of your search traffic
* See which countries drive the most clicks
**Devices**
* Performance by device type (Desktop, Mobile, Tablet)
* Compare metrics across device categories
## Search Types [#search-types]
GSC tracks different search types:
| Type | Description |
| -------- | ---------------------- |
| Web | Standard Google search |
| Image | Google Images |
| Video | Video search results |
| News | Google News |
| Discover | Google Discover feed |
## Filtering & Comparison [#filtering--comparison]
### Advanced Filtering [#advanced-filtering]
Filter your GSC data by:
* **Query**: Focus on specific keywords
* **Page**: Analyze individual page performance
* **Country**: See performance by region
* **Device**: Compare desktop vs. mobile
Click any row in the data tables to quickly filter by that value.
### Date Range Comparison [#date-range-comparison]
Compare performance across time periods:
* Select any date range
* Enable comparison mode
* See change percentages for all metrics
* Identify trends and anomalies
## Analyzing Performance [#analyzing-performance]
### Finding Opportunities [#finding-opportunities]
Look for keywords where:
* High impressions, low clicks (improve titles/descriptions)
* Position 11-20 (almost on page 1)
* High CTR (double down on what works)
### Identifying Issues [#identifying-issues]
Watch for:
* Sudden drops in impressions
* Declining positions
* Pages losing clicks
## Best Practices [#best-practices]
### Monitor Regularly [#monitor-regularly]
Check GSC data weekly for:
* Traffic trends
* Ranking changes
* New query opportunities
* Technical issues
### Focus on Key Pages [#focus-on-key-pages]
Prioritize:
* Homepage
* Main product/service pages
* High-traffic blog posts
* Landing pages
### Respond to Changes [#respond-to-changes]
When you see drops:
1. Check for algorithm updates
2. Review recent site changes
3. Look for technical issues
4. Analyze competitor changes
## Data Freshness [#data-freshness]
| Data Type | Freshness |
| ---------------- | ------------------- |
| Performance data | Delayed 2 to 3 days |
VitalSentinel syncs GSC data regularly. After linking a new property, allow up to 24 hours for initial data collection.
## Deep-Dive Reports [#deep-dive-reports]
Beyond the overview dashboard, GSC has eight dedicated analysis pages accessible from the GSC sidebar. Each one runs as a standalone report – you don't need to configure anything; data updates automatically when fresh GSC data arrives.
### Opportunities [#opportunities]
Find high-ROI queries where a small ranking or CTR boost converts into measurable clicks.
* **Query Performance Quadrant** - Bubble chart with CTR on the X-axis (log scale), average position on the Y-axis (log scale), bubble size = clicks, color = device. Reference lines split the chart into four quadrants: **Stars** (top-right, strong rank + strong CTR), **Title candidates** (good rank, weak CTR – rewrite titles/descriptions), **Hidden gems** (weak rank, strong CTR – try to push to page 1), and **Underperformers** (weak rank, weak CTR).
* **AI Overview & Zero-Click Erosion** - Estimates the share of branded traffic captured by AI Overviews vs. an industry benchmark, with a 28-day trend sparkline.
* **CTR Benchmark** - Your CTR by ranking position vs. an industry baseline, so you can spot positions where you're under-clicking.
* **Page Poaching** - Queries where you rank in striking distance (positions 4–20), with the estimated click gain if you moved up to the top three.
* **Opportunity Scoring** - Sortable table that ranks queries by a 0–100 score combining impressions, CTR gap, position decay, and momentum, plus an effort label (easy / medium / hard).
### Cannibalization [#cannibalization]
Identify queries where multiple URLs on your site compete and Google splits impressions across them instead of funneling traffic to one dominant page.
* Rolling 28-day window.
* Toggles to **exclude pagination URLs** and **exclude brand queries**.
* Each row shows the primary URL, its average position, the count of competing URLs (click to see them all), and the **impressions at risk** – the volume Google could consolidate to your primary if cannibalization is resolved.
* Drift annotations flag queries where the dominant URL changed during the window.
### Clusters [#clusters]
Organize your queries and pages into topic clusters to find content gaps and structural weaknesses.
* **Topic Clusters** - Each cluster shows an auto-generated label, intent (navigational / informational / transactional / mixed), query count, total clicks, median position, and a health badge (healthy / watch / declining). Click a row to open a detail modal with sample queries, ranking pages, and a weekly trend chart.
* **Page Template Benchmark** - Compares CTR by page template (e.g., blog vs. product vs. homepage) against expected CTR for the same position, so you can see which templates over- or under-perform.
### Correlations [#correlations]
Cross-signal views that pair GSC data with your own RUM and Web Analytics. Unique to VitalSentinel because the same workspace stores all three datasets.
* **Core Web Vitals × Rankings** - Table grouped by Web Vitals cohort (Good / Needs Improvement / Poor) for the metric and device you pick. Shows median position, median CTR, and an **estimated click gain** if Poor pages were improved to Good.
* **Post-Click Engagement** - Pairs GSC clicks with GA4 bounce rate, session duration, and conversion rate per URL – surfaces pages that drive clicks but disengage users on arrival.
### Trends [#trends]
Detect anomalies and pages losing performance over time.
* **Traffic Anomalies** - 90-day daily clicks line chart with detected anomalies highlighted (observed vs. expected, ±2σ from rolling mean). Below the chart, a table lists each anomaly with the delta, the likely cause if it lines up with a calendar event, and historical precedent.
* **Content Decay** - Pages with declining clicks (last 14 days vs. prior 14 days), with a trend direction indicator and an estimated recovery time.
### Data Quality [#data-quality]
Surface hidden data and data accuracy gaps so you understand what your numbers can't tell you.
* **Sampling Impact** - Percentage of clicks Google anonymizes (low-volume queries) vs. an industry average, with a 28-day trend.
* **Sitemap Orphans** - URLs in your sitemap that produce no GSC clicks or impressions (not indexed or sub-threshold).
* **Indexation Reconciliation** - Compares GSC's "Indexed" count against your XML sitemap and Googlebot coverage to flag discrepancies.
* **Data Quality Diagnostics** - Summary tiles for sampled %, API row-cap hits, and discrepancies between exports, with concrete recommendations.
### Experiments [#experiments]
Define query- or page-level hypothesis tests and measure their impact on clicks, impressions, CTR, or position. Not a true A/B testing framework – it's controlled-window analysis using GSC data you already have.
* **Methods** - Mann–Whitney U (non-parametric), Difference-in-Differences (DiD), and Bayesian Structural Time-Series (BSTS) for causal inference.
* **Lifecycle** - Draft → Running → Concluded (or Abandoned). Edit while in draft; once running, the configuration is locked.
* **Detail view** - Treatment vs. control timeline, 95% confidence interval, effect size, p-value, and a recommendation to scale up or hold.
### Internationalization [#internationalization]
Validate hreflang and locale targeting – make sure pages in each language reach the right countries and aren't wasting impressions in wrong-language markets.
* **Locale Alignment** - Auto-discovered locales (no manual config) with target traffic share, aligned clicks, misaligned clicks, and the top countries where each locale is leaking.
* **Geographic Drift** - URLs ranking in countries where the page locale doesn't match the expected language. Excludes root-level pages to reduce false positives.
## Related Monitoring [#related-monitoring]
* **CrUX Monitoring** - Core Web Vitals affect search rankings
* **Synthetic Monitoring** - Performance issues can impact crawling
For tracking which pages are indexed, see [Indexing Monitoring](/features/indexing-monitoring).
## Troubleshooting [#troubleshooting]
### No Data Showing [#no-data-showing]
1. Verify GSC is connected in workspace settings
2. Check that the correct property is linked
3. Ensure the domain has enough search traffic
4. Wait 2-3 days for data to appear
### Wrong Property [#wrong-property]
1. Go to domain settings
2. Unlink the current property
3. Select the correct property
4. Re-link
### Access Denied [#access-denied]
1. Verify you have access in Google Search Console
2. Re-authorize the Google connection
3. Check that sharing permissions are correct
## Related Features [#related-features]
Track page indexing status
Core Web Vitals affect rankings
Import GA4 traffic data