Google Analytics

get_ga_summary

Get aggregated GA4 metrics (sessions, active users, page views, conversions, bounce rate) for a property over a date range. Defaults to last 30 days.

get_ga_realtime

Get a realtime GA4 snapshot (last ~30 min): active users, by-minute traffic, top screens, top sources. Always hits the live GA4 API.

get_ga_realtime_all

Get a combined realtime GA4 snapshot across ALL properties the workspace can access (last ~30 min): summed active users, merged by-minute traffic, merged top screens, merged top countries. Always hits the live GA4 API. Use this for the 'All properties' view in the Realtime tab.

get_ga_timeseries

Get the GA4 daily engagement time series for a property (sessions, active users, page views, conversions). Defaults to last 30 days.

get_ga_top_pages

Get the top landing pages by active users (last sync snapshot) for a property.

get_ga_top_events

Get the top events by event count (last sync snapshot) for a property.

get_ga_breakdown

Get sessions/active users broken down by a GA4 dimension. Dimension must be one of: country, deviceCategory, sessionDefaultChannelGroup, sessionManualSource, cityName, browser, operatingSystem.

get_ga_properties

List all GA4 properties the connected Google account can access, and persist them. Falls back to the last-synced list when the live fetch can't run.

set_ga_property

Link a GA4 property to a project so the project's analytics read from it. Writes projects.ga_property_id.

get_ga_sync_runs

List recent GA4 sync runs for a property (audit trail: status, stage, rows, errors).

get_ga_connection_status

Check whether a Google Analytics connection is available AND carries the analytics.readonly scope for the current user/workspace. Prefers a dedicated google-analytics connection, falling back to the shared google connection.

list_ga_accounts

List the GA4 accounts the connected Google user can access (id + display name), for the parent-account picker in the bulk property-creation flow. Requires the analytics.edit scope.

create_ga_property

Create a single GA4 property under a parent account via the Google Analytics Admin API. Requires the analytics.edit scope. Returns the created property (property_id + display_name).

create_ga_properties_for_domains

Bulk-create one GA4 property per domain under a parent account via the Google Analytics Admin API. Pass an array of domains + the parent account_id; one property is created per domain (display_name = domain, timeZone UTC, currency USD). Returns a per-domain result array so partial failures (quota, duplicates) are visible. Requires the analytics.edit scope.

get_ga_measurement_snippet

Get the Google Analytics gtag.js measurement ID (G-XXXXXX) and ready-to-paste tracking snippet for an existing GA4 property by listing its web data streams. Creates nothing. Use this after create_ga_property (without website_url) or for a property created in the GA4 console to retrieve the tracking code to add to your website. Requires an analytics connection (analytics.readonly or analytics.edit).

scheduled_fetch

Sync Google Analytics data for a property. fetch_type: daily (last N days of metrics + breakdowns + top pages/events), realtime (live snapshot). Uses platform-managed credentials.