Google Analytics 4 / API Reference
ga4_run_custom_report
Run a fully custom GA4 report with your own dimensions and metrics. Use this only when preset GA4 tools do not fit the request. For common asks like overview, traffic sources, top pages, or conversions, prefer the dedicated GA4 tools.
This is a read-only tool: it returns run custom report for your Google Analytics 4 account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Run custom report in my Google Analytics 4 account for [dimensions], [metrics].
It takes 2 required and 5 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
dimensions | string | Yes | Dimensions |
metrics | string | Yes | Metrics |
property_id | string | No | Property Id |
start_date | string | No | Start Date |
end_date | string | No | End Date |
row_limit | integer | No | Row Limit |
order_by_metric | string | No | Order By Metric |
Related Google Analytics 4 tools
ga4_acquisition_channelsga4_attribution_pathsga4_audiencesga4_audit_property_settingsga4_available_metricsga4_bulk_create_key_events
Before you can call it
This tool needs a connected Google Analytics 4 account. The Google Analytics 4 connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: