Connect and use Google Analytics
Authorize GA4 separately, link the correct property, compare traffic outcomes with search work, and use bounded Analytics reports through MCP.
Product guide · Updated August 2026
Requirements and access
Live Google Analytics reporting is available for sites with full workspace access. The Google account must be able to see the intended GA4 property. Analytics authorization is separate from CrawlRaven sign-in and Search Console authorization.
Connect a GA4 property
- 1
Open the site
Choose the correct site from the portfolio or site switcher, then select GA4 under Traffic. - 2
Select Connect Google Analytics
A separate Google authorization flow opens. - 3
Choose an Analytics account
Use an account with at least Viewer access to the required GA4 property. - 4
Select the property
CrawlRaven lists visible properties with their Analytics account name and property ID. - 5
Wait for the dashboard
After linking, the GA4 report loads sessions, users, key events, and breakdowns.
If no properties appear, grant the authorized account Viewer access in GA4 or select Authorize a different Google account. If you chose the wrong property, use Change property above the chart and connect again.
Read the GA4 report
| Metric | Meaning |
|---|---|
| Active users | Distinct engaged users in the selected report scope. |
| Sessions | Visits started during the period. |
| Key events | Events you marked as important in GA4. |
| Events | All recorded events in the selected period. |
Select KPI tiles to change the chart metrics and switch between Line and Area. The breakdown panels show Landing pages, Source / medium, Countries, and Devices. Select a row in a panel to apply it as an exact dashboard filter.
Filter outcomes and use them in Opportunities
- Choose rolling, calendar, extended, or custom date ranges from the calendar menu.
- Filter Landing page and Source / medium by Contains or Exactly matches.
- Filter Country exactly and choose Any, desktop, mobile, or tablet for Device.
- Use Growing, Declining, New, and Lost to filter all breakdown panels against the comparison period.
- Add Events and annotations to the same timeline used in Search performance.
When a page can be matched and has enough organic sessions, Opportunities can show page-level sessions, key events, and session key-event rate as outcome evidence. This can increase Priority while leaving the underlying SEO impact score visible.
Read linked GA4 reports through MCP
Paid MCP connections can separately request the View analytics permission. Its OAuth scope name is analytics:read. This permission is not bundled into Search performance access, and existing connections do not gain it automatically. Reconnect the client and explicitly approve it.
| Tool | Use it for |
|---|---|
| get_analytics_summary | Active users, sessions, key events, event count, daily series, and the preceding-period comparison. |
| get_analytics_breakdown | Up to 100 top rows by Content group, Landing page, Source / medium, Country, or Device, with an explicit truncation flag. |
- Choose rolling or exact inclusive windows up to 365 complete UTC days, ending no later than yesterday.
- Filter Landing page or Source / medium by exact or contains; filter Country or Device by exact value.
- Results identify GA4 as the provider and use only the property already linked to the CrawlRaven website.
- MCP cannot connect or switch properties, expose provider credentials, or change Analytics configuration.
- Analytics tools are paid-only and unavailable in the free MCP preview. CrawlRaven does not persist their GA4 report rows.