Weave
Sign InSign Up
View as .md ↗
Google Analytics

Google Analytics | Key Events

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_key-events

Key events (conversions) by page and event type. If the property has no key events configured, falls back to top events with isFallback set to true — those are NOT conversions. Scope with organicOnly (default true). 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)
limitinteger— Max rows to return (up to 50). Defaults to 25 when omitted. Matches the partner's own advertised tools/list inputSchema bound (oracle epic #1106 comment) — a narrower cap than the other ga4 tools' shared 1-100 ga4Limit.(>= 1, <= 50)
organicOnlyboolean— Filter to organic search only. Defaults to true when omitted.

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), "All Traffic" when false. This tool has no channelFilter input, so scope is never a specific channel.
isFallbackbooleanrequired— True when the property has no key events configured and these are ordinary events instead. They are NOT conversions and must not be presented as such.
rowsarrayrequired— Page and event pairs ranked by count.
[]object
pagestringrequired— Page path where the event fired.
eventNamestringrequired— GA4 event name.
countnumberrequired— Key events, or plain event count when isFallback is true.
sessionsnumberrequired— Sessions.

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 Key Events tool do?

This page documents the Key Events tool (ga4_key-events). Key events (conversions) by page and event type. If the property has no key events configured, falls back to top events with isFallback set to true, those are NOT conversions. Scope with organicOnly (default true). Run ga4_list-properties first if you don't have a property ID. It is one of the Google Analytics Conversions tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

What does isFallback mean here?

True when the property has no key events configured, the rows are ordinary events instead, ranked by plain event count. Those are NOT conversions and must not be presented as such.

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

pagesretention-trend