Weave
Sign InSign Up
View as .md ↗
Google Analytics

Google Analytics | Breakdown

MCP server · Marketing · analytics.google.com · 5 categories · 11 tools

Powered by Advanced GSC ↗

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.

ga4_breakdown

One-dimension traffic breakdown: channel, device, country, sourceMedium, newVsReturning, or contentGroup. Scope with organicOnly (default true; rejected for dimension "channel") or channelFilter. Shares are computed against GA4's own total, which the rows will not sum to. Run ga4_list-properties first if you don't have a property ID.

Tool Input

propertyIdstringrequired— Numeric GA4 property ID (e.g. "123456789"). Get it from ga4_list-properties if you don't have one.(pattern: ^\d{1,15}$)
startDatestring— Window start. "30daysAgo" or YYYY-MM-DD. Defaults to "30daysAgo" when omitted.(min length: 1, max length: 30)
endDatestring— Window end. "today" or YYYY-MM-DD. Defaults to "today" when omitted.(min length: 1, max length: 30)
dimensionstringrequired— Breakdown dimension.(enum: "channel", "device", "country", "sourceMedium", "newVsReturning", "contentGroup")
organicOnlyboolean— Organic Search only. Defaults to true (except dimension "channel"). organicOnly:true is mutually exclusive with channelFilter (organicOnly:false may be combined with channelFilter). Any organicOnly value is rejected together with dimension "channel".
channelFilterstring— Scope to one channel, e.g. "Organic Social". Mutually exclusive with organicOnly:true and with dimension "channel".(min length: 1)
rawSourcesboolean— sourceMedium only: show GA4 raw referrer hosts instead of normalized platforms. Defaults to false when omitted.
limitinteger— Max rows to return (up to 100). Defaults to 25 when omitted.(>= 1, <= 100)

Tool Output

propertyIdstringrequired— The GA4 property this data came from, as a bare numeric id.
startDatestringrequired— Window start, echoing the request ("YYYY-MM-DD" or a relative form).
endDatestringrequired— Window end, echoing the request.
scopestringrequired— Traffic scope applied — "Organic Search" when organicOnly is true (the default for every dimension except "channel"), "All Traffic" when false, or the requested channel when channelFilter is set. Always "All Traffic" for dimension "channel", where organicOnly/channelFilter are rejected as inputs — the channel report itself IS the all-traffic-by-channel breakdown.
dimensionstringrequired— The dimension the rows are grouped by. Known values: "channel", "device", "country", "sourceMedium", "newVsReturning", "contentGroup".
rowsarrayrequired— Groups ranked by sessions.
[]object
labelstringrequired— The dimension value.
sessionsnumberrequired— Sessions.
sharenumberrequired— This row's share of totalSessions, as a percentage (0-100).
usersnumberrequired— Active users. Not additive across rows: GA4 de-duplicates them.
engagementRatenumberrequired— Engaged sessions as a percentage (0-100).
bounceRatenumberrequired— Non-engaged sessions as a percentage (0-100). The inverse of engagement rate.
avgSessionDurationSecondsnumberrequired— Average engagement time per session, in seconds.
keyEventsnumberrequired— Key events (GA4 conversions).
totalSessionsnumberrequired— GA4's own undimensioned total. Rows will not sum to it (thresholding, "(other)" aggregation, unattributable sessions), so compute shares against this rather than a row sum.
sourcesNormalizedbooleanrequired— True when raw referrer hosts were collapsed under canonical sources (m.facebook.com under facebook). Pass rawSources: true to see GA4's raw hosts.
notSetPresentbooleanrequired— An unclassifiable bucket exists in the data (cookieless or cross-device sessions). Tracked separately because it can rank below the display limit and still matter.
emptyReasonstringrequired— Why rows is empty. Known values: "none", "no_data", "content_groups_unassigned" (the property has content groups configured but no page is assigned to one).

We're Adding More Google Analytics Tools Constantly!

Don't see a specific Google Analytics tool you need? Email [email protected] and we can add it.

Google Analytics Frequently Asked Questions

What does the Breakdown tool do?

This page documents the Breakdown tool (ga4_breakdown). One-dimension traffic breakdown: channel, device, country, sourceMedium, newVsReturning, or contentGroup. Scope with organicOnly (default true; rejected for dimension "channel") or channelFilter. Shares are computed against GA4's own total, which the rows will not sum to. Run ga4_list-properties first if you don't have a property ID. It is one of the Google Analytics Content tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

Why does dimension "channel" reject organicOnly and channelFilter?

The channel report is itself the all-traffic-by-channel breakdown, so scoping it to organic-only or a single channel would be circular, both inputs are rejected together with dimension: "channel". For every other dimension, organicOnly defaults to true.

Why don't the row shares sum to 100%?

Shares are computed against GA4's own totalSessions, not a sum of the returned rows, thresholding, an "(other)" aggregation bucket, and unattributable sessions mean the rows will not add up to the total.

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 Tools

pagescompare-periodstrend