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

# Google Analytics & Search Console

> Connect GA4 and GSC to import search and traffic performance data.

WisePilot imports data from Google Analytics 4 (GA4) and Google Search Console (GSC) to power performance scoring, trend analysis, and content optimization.

## What Gets Imported

### Google Search Console

| Metric               | Description                                   | Used For               |
| -------------------- | --------------------------------------------- | ---------------------- |
| **Impressions**      | How often your pages appear in search results | Visibility scoring     |
| **Clicks**           | How often users click through from search     | Traffic scoring        |
| **CTR**              | Click-through rate from search results        | Content quality signal |
| **Average position** | Your ranking position for target queries      | Ranking tracking       |

### Google Analytics 4

| Metric         | Description                             | Used For           |
| -------------- | --------------------------------------- | ------------------ |
| **Pageviews**  | Total and unique views per page         | Traffic scoring    |
| **Users**      | Visitor counts (new vs. returning)      | Audience analysis  |
| **Engagement** | Time on page, scroll depth, bounce rate | Engagement scoring |

## Connecting

1. Navigate to **Integrations → GA4 & GSC**
2. Click **Connect Google Account**
3. Authenticate with your Google credentials (the account must have access to both GA4 and GSC)
4. **Select GA4 property** — Choose the Analytics property that corresponds to your website
5. **Select GSC site** — Choose the Search Console property for the same domain
6. Click **Save** — Data import begins automatically

### Permissions Required

* **GA4** — Viewer access or higher to the selected property
* **GSC** — Owner or full user access to the selected site

## How Data Flows

Once connected, WisePilot imports data as **daily snapshots** automatically every night:

1. **Nightly import** — Yesterday's metrics are pulled from GA4 and GSC (runs around midnight UTC)
2. **Path matching** — Metrics are matched to your content assets using page paths
3. **Rollup** — Data feeds into the daily performance rollup alongside GTM and HighLevel data
4. **Scoring** — Optimization scores are recalculated with the fresh data

By morning, your dashboards reflect yesterday's performance. Expect a \~24 hour delay on all Google data — this is normal and inherent to how Google APIs report data.

<Tip>When you first connect, you can backfill up to 90 days of historical data from the integration settings page rather than waiting for it to accumulate day by day. See [Automation & Data Freshness](/optimization/automation#backfill-and-manual-sync) for details.</Tip>

### Matching Pages to Assets

WisePilot matches GA4/GSC page paths to content assets using the `canonical_path` field on each asset. If an asset's canonical path is `/blog/reduce-churn`, all GA4 and GSC metrics for that path are attributed to that asset.

<Note>If your assets are missing `canonical_path` values, performance data won't link to them. Set the canonical path when you publish content, or update it manually in the asset detail view.</Note>

## Verifying the Connection

After connecting, check that data is flowing:

1. Go to the [Data Quality Console](/optimization/data-quality)
2. Check the **Freshness** section for GA4 and GSC snapshots
3. Both should show data within the last 24 hours
4. If either shows "No events" or stale timestamps, troubleshoot below

## Troubleshooting

### No GA4 data appearing

* Verify the correct GA4 property is selected (some accounts have multiple properties)
* Check that your Google account has Viewer access to the property
* Wait 24 hours — the first import runs on the next scheduled cycle
* Check the Data Quality Console for freshness timestamps

### No GSC data appearing

* Verify the correct Search Console property is selected
* Check that your Google account has Full User access (Viewer is insufficient for API access)
* New GSC properties may take a few days to accumulate data

### Metrics don't match what I see in GA4/GSC

* WisePilot imports daily aggregates, not real-time data. Expect a 24–48 hour delay.
* Metrics are scoped to specific page paths. If your GA4 has different URL structures (trailing slashes, query parameters), they may not match the `canonical_path` in WisePilot.