Tool-Referenz — Daten & Website

Google Analytics 4 tools

Overview, channel and landing page reports, realtime data, conversion events and Google Ads links.

Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind der englische Originaltext, den der Assistent sieht.

Lese-Tools10 Tools

list_ga4_properties

Lesen1 Credits

GA4 properties (id, name, account) the connected Google account can read, plus the default property used when property_id is omitted.

Dieses Tool hat keine Parameter.

ga4_report

Lesen1 Credits

Custom 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	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–730)	window ending today when dates are omitted (default 30)
`metrics`Optional	array<string>	GA4 Data API metric names, default [sessions, totalUsers, keyEvents]
`dimensions`Optional	array<string>	GA4 dimension names, e.g. sessionDefaultChannelGroup, landingPage, date, country, deviceCategory, eventName
`filters`Optional	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`order_by`Optional	string	a metric or dimension in the request
`order`Optional	asc \| desc	—
`limit`Optional	integer (1–10000)	—
`offset`Optional	integer (0–…)	—

ga4_overview

Lesen1 Credits

Overview 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	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–730)	window ending today when dates are omitted (default 30)
`compare_previous`Optional	boolean	—

ga4_realtime

Lesen1 Credits

Active users right now (last 30 minutes) and where they are — by page/screen title by default.

Parameter	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`dimensions`Optional	array<string>	realtime dimensions: unifiedScreenName (default), country, city, deviceCategory, eventName, platform
`metrics`Optional	array<string>	realtime metrics: activeUsers (default), screenPageViews, eventCount, keyEvents
`limit`Optional	integer (1–1000)	—

ga4_landing_pages

Lesen1 Credits

Landing pages with sessions, engaged sessions, key events (conversions), revenue and conversion rate, ordered by key events by default.

Parameter	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–730)	window ending today when dates are omitted (default 30)
`filters`Optional	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`with_query_string`Optional	boolean	—
`order_by`Optional	keyEvents \| sessions \| engagedSessions \| totalRevenue	—
`limit`Optional	integer (1–1000)	—

ga4_channel_report

Lesen1 Credits

Sessions, engaged sessions, users, key events (conversions), revenue and rates by default channel group (or source/medium/campaign).

Parameter	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–730)	window ending today when dates are omitted (default 30)
`filters`Optional	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`dimension`Optional	string	sessionDefaultChannelGroup (default), sessionSource, sessionMedium, sessionCampaignName, sessionSourceMedium
`limit`Optional	integer (1–1000)	—

ga4_vs_google_ads

Lesen2 Credits

GA4 '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	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`days`Optional	integer (1–90)	—

list_ga4_google_ads_links

Lesen1 Credits

Google Ads accounts linked to the GA4 property (customer id, personalization flag, creator, created time); linked=false flags a property with no link.

Parameter	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

list_ga4_conversion_events

Lesen1 Credits

Conversion (key) events defined on the property with counting method and custom/deletable flags.

Parameter	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

list_ga4_custom_dimensions

Lesen1 Credits

Custom dimensions on the property (parameter name, display name, scope).

Parameter	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

Schreib-Tools3 Tools

create_ga4_conversion_event

Schreiben2 Credits

Mark 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	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`event_name`Pflicht	string	—
`counting_method`Optional	ONCE_PER_EVENT \| ONCE_PER_SESSION	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_ga4_custom_dimension

Schreiben2 Credits

Create a custom dimension (event, user or item scope). Goes through preview and approval before the Admin API call.

Parameter	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`parameter_name`Pflicht	string	—
`display_name`Optional	string	—
`scope`Optional	EVENT \| USER \| ITEM	—
`description`Optional	string	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_ga4_google_ads_link

Schreiben2 Credits

Link 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	Typ	Beschreibung
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`customer_id`Pflicht	string	Google Ads customer id, 123-456-7890
`ads_personalization`Optional	boolean	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.