# Traffic Overview

`ga4_traffic-overview` · Google Analytics MCP tool · Traffic

High-level traffic summary: sessions, users, bounce rate, avg duration, pageviews. Run ga4_list-properties first if you don't have a property ID.

## Google Analytics Frequently Asked Questions

**What does the Traffic Overview tool do?**

This page documents the Traffic Overview tool (`ga4_traffic-overview`). High-level traffic summary: sessions, users, bounce rate, avg duration, pageviews. Run ga4_list-properties first if you don't have a property ID. It is one of the Google Analytics Traffic tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

**What is the Google Analytics integration?**

The Google Analytics integration connects your firm's Google Analytics account to Weave. Google Analytics is Google's web and app analytics platform. This integration lets your AI workflows read that data, properties, audience and engagement metrics, and traffic sources, for the properties your connected Google account can access. It groups 11 tools into 5 categories, exposed through your firm's Weave MCP connection and filtered per member by access level.

**How does my firm connect Google Analytics to Weave?**

An admin authorizes a Google account with access to your GA4 properties once, via Google's OAuth consent flow in the Weave console. Every firm member then works through that single connection, there is no per-member Google sign-in.

**Can these tools change anything in Google Analytics?**

No. Every ga4 tool is read-only reporting, none of them can edit a property, change tracking configuration, or modify GA4 data.

**Do I need to specify a property every time?**

Yes, run ga4_list-properties first to get the numeric propertyId for the account/property you want; every other ga4 tool requires it.

**What does organicOnly mean on these reports?**

Most tools default to organicOnly: true, scoping the report to organic search traffic; widen the scope with organicOnly: false, or narrow it further with a channelFilter where the tool supports one.

## Related
- /integrations/ga4/properties/
- /integrations/ga4/content/
- /integrations/gsc/search-analytics/
- /integrations/ga4/traffic/compare-periods/
- /integrations/ga4/traffic/realtime/
- /integrations/ga4/traffic/trend/

## Input

- **propertyId** `string` (required, pattern: ^\d{1,15}$) — Numeric GA4 property ID (e.g. "123456789"). Get it from ga4_list-properties if you don't have one.
- **startDate** `string` (min length: 1, max length: 30) — Window start. "30daysAgo", "7daysAgo", or YYYY-MM-DD. Defaults to "30daysAgo" when omitted.
- **endDate** `string` (min length: 1, max length: 30) — Window end. "today" or YYYY-MM-DD. Defaults to "today" when omitted.

## Output

- **propertyId** `string` (required) — The GA4 property this data came from, as a bare numeric id.
- **startDate** `string` (required) — Window start, echoing the request ("YYYY-MM-DD" or a relative form).
- **endDate** `string` (required) — Window end, echoing the request.
- **totals** `object | null` (required) — null when the property returned no rows for this window.
  - **sessions** `number` (required) — Sessions.
  - **activeUsers** `number` (required) — Active users. Not additive across rows: GA4 de-duplicates them.
  - **newUsers** `number` (required) — First-time users in the window.
  - **returningUsers** `number` (required) — Approximated as activeUsers minus newUsers. GA4 has no direct returning-users metric, so treat this as an estimate.
  - **pageviews** `number` (required) — Screen page views.
  - **bounceRate** `number` (required) — Non-engaged sessions as a percentage (0-100). The inverse of engagement rate.
  - **avgSessionDurationSeconds** `number` (required) — Average engagement time per session, in seconds.