Google Analytics 4 tools
Overview, channel and landing page reports, realtime data, conversion events and Google Ads links.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools10 tools
list_ga4_properties
読み取り1 creditsGA4 properties (id, name, account) the connected Google account can read, plus the default property used when property_id is omitted.
This tool takes no parameters.
ga4_report
読み取り1 creditsCustom GA4 report (runReport): any dimensions × metrics for a date range with filters, ordering and limit. Rows carry conversion_rate (keyEvents/sessions %) when both are present. 'conversions' are GA4 key events (metric keyEvents). Requires a connected Google account; otherwise connected=false.
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–730) | window ending today when dates are omitted (default 30) |
metricsOptional | array<string> | GA4 Data API metric names, default [sessions, totalUsers, keyEvents] |
dimensionsOptional | array<string> | GA4 dimension names, e.g. sessionDefaultChannelGroup, landingPage, date, country, deviceCategory, eventName |
filtersOptional | array<object> | AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
order_byOptional | string | a metric or dimension in the request |
orderOptional | asc | desc | — |
limitOptional | integer (1–10000) | — |
offsetOptional | integer (0–…) | — |
ga4_overview
読み取り1 creditsOverview totals for the period: sessions, users, new users, engaged sessions, key events (conversions), revenue, page views, with engagement and conversion rates; compare_previous adds the preceding equal period and change.
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–730) | window ending today when dates are omitted (default 30) |
compare_previousOptional | boolean | — |
ga4_realtime
読み取り1 creditsActive users right now (last 30 minutes) and where they are — by page/screen title by default.
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
dimensionsOptional | array<string> | realtime dimensions: unifiedScreenName (default), country, city, deviceCategory, eventName, platform |
metricsOptional | array<string> | realtime metrics: activeUsers (default), screenPageViews, eventCount, keyEvents |
limitOptional | integer (1–1000) | — |
ga4_landing_pages
読み取り1 creditsLanding pages with sessions, engaged sessions, key events (conversions), revenue and conversion rate, ordered by key events by default.
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–730) | window ending today when dates are omitted (default 30) |
filtersOptional | array<object> | AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
with_query_stringOptional | boolean | — |
order_byOptional | keyEvents | sessions | engagedSessions | totalRevenue | — |
limitOptional | integer (1–1000) | — |
ga4_channel_report
読み取り1 creditsSessions, engaged sessions, users, key events (conversions), revenue and rates by default channel group (or source/medium/campaign).
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–730) | window ending today when dates are omitted (default 30) |
filtersOptional | array<object> | AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
dimensionOptional | string | sessionDefaultChannelGroup (default), sessionSource, sessionMedium, sessionCampaignName, sessionSourceMedium |
limitOptional | integer (1–1000) | — |
ga4_vs_google_ads
読み取り2 creditsGA4 'Paid Search' channel (sessions, key events, revenue) next to Google Ads spend, clicks, conversions and CPA for the same last-N-days window, with the attribution gap. If Google Ads is not connected the Ads side is null with a note.
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
daysOptional | integer (1–90) | — |
list_ga4_google_ads_links
読み取り1 creditsGoogle Ads accounts linked to the GA4 property (customer id, personalization flag, creator, created time); linked=false flags a property with no link.
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
list_ga4_conversion_events
読み取り1 creditsConversion (key) events defined on the property with counting method and custom/deletable flags.
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
list_ga4_custom_dimensions
読み取り1 creditsCustom dimensions on the property (parameter name, display name, scope).
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
Write tools3 tools
create_ga4_conversion_event
書き込み2 creditsMark a GA4 event as a conversion (key event). Creates an approval item with a preview; applied via the Admin API only after approval and only with a connected account that has edit access.
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
event_nameRequired | string | — |
counting_methodOptional | ONCE_PER_EVENT | ONCE_PER_SESSION | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_ga4_custom_dimension
書き込み2 creditsCreate a custom dimension (event, user or item scope). Goes through preview and approval before the Admin API call.
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
parameter_nameRequired | string | — |
display_nameOptional | string | — |
scopeOptional | EVENT | USER | ITEM | — |
descriptionOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_ga4_google_ads_link
書き込み2 creditsLink a Google Ads account to the GA4 property so conversions flow to Google Ads. Goes through preview and approval; requires edit access on both sides.
| Parameter | Type | Description |
|---|---|---|
property_idOptional | string | GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options. |
customer_idRequired | string | Google Ads customer id, 123-456-7890 |
ads_personalizationOptional | boolean | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.