Docs menu
Get started
What is Opus GrowthQuickstartAdd to your AIHow it worksSafety and approvalCreditsPlansFAQAI apps
All AI appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOther MCPConnect ad platforms
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencies and MCCConnect data sources
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWebsites and SEO
AI ServerWordPressSEO IntelligenceClick fraudTool reference
All toolsGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceClick fraudCross-channelAccount and billingLanguage
GA4 Breakdown Report
GA4 breakdown report: sessions / users / key events (conversions) / total events by a dimension.
- Type
- Reads only
- Credits
- 2
- Platform
- Google Analytics
- Approval
- Not needed, nothing changes
What it does
GA4 breakdown report: sessions / users / key events (conversions) / total events by a dimension. dimension: channel (default) | source | medium | source_medium | page | landing_page | country | device | date | event. The channel/source breakdown answers 'which traffic converts'.
dimension='event' splits by EVENT NAME, which is the only way to isolate ONE key event. Without it `conversions` is the SUM of every key event in the property, so a property with purchase + form_sent + mql reports a single number that cannot be reconciled against what an ad platform counted — the most common check in any paid media audit. ga4_list_conversions shows which event names are key events. dimension2 crosses a SECOND dimension with the first (dimension='event' + dimension2='source_medium' gives events per traffic source). Rows then carry both dimension fields. `events` is the raw event count and `conversions` counts only key events, so on an event row the two differ whenever that event is not a key event. Every GA4 row is retained: limit controls only the number returned in this response (0 = as many as fit, about 370 KB); when has_more is true, call again with page_token=next_page_token to retrieve the remaining rows without re-running the report or using another credit.
MCP: ga4_report
How to use it
You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.
Parameters
| Name | Type | Required | Default | |
|---|---|---|---|---|
| property | string | Optional | · | Exact connected property identifier or resource name returned by the relevant property-listing tool. |
| dimension | string | Optional | channel | Exact dimension value for ga4 report. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation. |
| days | integer | Optional | 28 | Number of calendar days to look back from now for this analysis or report. |
| limit | integer | Optional | 0 | Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete. |
| dimension2 | string | Optional | · | Exact dimension2 value for ga4 report. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation. |
| start_date | string | Optional | · | Inclusive start date for the requested period, in the format required by this tool. |
| end_date | string | Optional | · | Inclusive end date for the requested period, in the format required by this tool. |
| page_token | string | Optional | · | Continuation token returned as next_page_token by a previous call. Leave empty for the first page; pass it unchanged to retrieve the cached next page. |
Related tools
ga4_create_conversionCreate GA4 Custom Dimensionga4_create_custom_dimensionLink GA4 to Google Adsga4_link_google_adsGA4 Google Ads Linksga4_list_ads_linksGA4 Conversionsga4_list_conversionsGA4 Data Streamsga4_list_data_streamsGA4 Propertiesga4_list_propertiesGA4 Overviewga4_overviewGA4 Realtime Usersga4_realtime