---
title: "Connect and use Google Analytics"
description: "Authorize a GA4 account separately, link the correct property, and connect traffic outcomes to search work."
canonical: "https://crawlraven.com/docs/google-analytics"
markdown: "https://crawlraven.com/docs/google-analytics.md"
product: "CrawlRaven v2"
last_verified: "2026-08-19"
---

# Connect and use Google Analytics

> Authorize a GA4 account separately, link the correct property, and connect traffic outcomes to search work.

This guide documents current CrawlRaven v2 behavior. UI labels are written exactly where relevant. Bounded Search Console rows are evidence, not guaranteed exhaustive totals.

## 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.

> **GA4 access is read-only:** CrawlRaven reads reporting data. It does not change Analytics settings, events, audiences, or attribution configuration.

## 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.

![CrawlRaven GA4 dashboard with active users, sessions, key events, chart, and breakdowns](/images/changelog/changelog-live-ga4-reporting-2026-08-14.png)

*GA4 uses the same report grammar as Search performance, making search visibility and traffic outcomes easier to compare.*

## 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.

> **Outcome matching is page level:** GA4 evidence helps identify commercially useful pages. It does not assign a key event to a specific Search Console query.