ga4_run_report
Run a Google Analytics 4 report: site-side sessions, users and conversions.
This is the OTHER side of the ad platforms. Where a platform reports the clicks it billed you for, GA4 reports the sessions that actually arrived, and the gap between them is where auto-tagging, redirects and consent banners hide. Use it to check an ad platform’s claim against the site, never as a second source for the same number.
Dates accept GA4’s own relative forms (28daysAgo, yesterday, today) as
well as YYYY-MM-DD. Metric and dimension names are GA4’s, not any ad
platform’s: sessions not clicks, sessionSource / sessionMedium /
sessionCampaignName for attribution.
Reports are read-only; no GA4 settings or events are changed. Scope is the
connected Analytics account’s selected properties. This is a bounded report,
not a paginated export: narrow dates or dimensions when truncated and never
total a partial result as the complete report.
Returns {rows, row_count, total_rows, truncated, metadata}. total_rows is GA4’s own
count, so a truncated report says so rather than looking complete.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
property_id | string | yes | GA4 property id, from ga4_list_properties. | |
metrics | string | yes | JSON array of GA4 metric names, e.g. [“sessions”,“totalUsers”]. | |
dimensions | string | no | "" | Optional JSON array of GA4 dimension names, e.g. [“sessionSource”,“sessionMedium”]. |
start_date | string | no | "28daysAgo" | GA4 date or relative date (default 28daysAgo). |
end_date | string | no | "yesterday" | GA4 date or relative date (default yesterday). |
limit | integer | no | 100 | Max rows (1-2000, default 100). |
Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.