Google-Analytics-4-Tools
Übersicht, Kanal- und Landingpage-Berichte, Echtzeitdaten, Conversion-Ereignisse und Google-Ads-Verknüpfungen.
Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind Übersetzungen des Textes, den der Assistent sieht, Tool- und Parameternamen bleiben unverändert.
Lese-Tools11 Tools
list_ga4_properties
Lesen1 CreditsGA4 Properties (id, name, account), die das verbundene Google Konto lesen kann, plus die Standard-Property, die verwendet wird, wenn property_id weggelassen wird.
Dieses Tool hat keine Parameter.
ga4_report
Lesen1 CreditsBenutzerdefinierter GA4 Bericht (runReport): beliebige Dimensionen × Metriken für einen Zeitraum mit Filtern, Sortierung und Limit. Zeilen enthalten conversion_rate (keyEvents/sessions %), wenn beide vorhanden sind. 'conversions' sind GA4 Schlüsselereignisse (Metrik keyEvents). Erfordert ein verbundenes Google Konto; andernfalls connected=false.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–730) | Zeitfenster bis heute, wenn keine Daten angegeben sind (Standard 30) |
metricsOptional | array<string> | Metriknamen der GA4 Data API, Standard [sessions, totalUsers, keyEvents] |
dimensionsOptional | array<string> | GA4 Dimensionsnamen, z. B. sessionDefaultChannelGroup, landingPage, date, country, deviceCategory, eventName |
filtersOptional | array<object> | AND-verknüpfte Dimensionsfilter, z. B. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
order_byOptional | string | eine Metrik oder Dimension aus der Anfrage |
orderOptional | asc | desc | — |
limitOptional | integer (1–10000) | — |
offsetOptional | integer (0–…) | — |
ga4_overview
Lesen1 CreditsÜbersichtssummen für den Zeitraum: Sitzungen, Nutzer, neue Nutzer, Sitzungen mit Interaktion, Schlüsselereignisse (Conversions), Umsatz, Seitenaufrufe, mit Interaktions- und Conversion-Raten; compare_previous fügt den vorhergehenden gleich langen Zeitraum und die Veränderung hinzu.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–730) | Zeitfenster bis heute, wenn keine Daten angegeben sind (Standard 30) |
compare_previousOptional | boolean | — |
all_propertiesOptional | boolean | true: every selected property of this project in one call (per-property rows + grand total); use for 'all my sites today' (days=1) |
ga4_realtime
Lesen1 CreditsAktive Nutzer gerade jetzt (letzte 30 Minuten) und wo sie sich befinden — standardmäßig nach Seiten-/Bildschirmtitel.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
dimensionsOptional | array<string> | Echtzeit-Dimensionen: unifiedScreenName (Standard), country, city, deviceCategory, eventName, platform |
metricsOptional | array<string> | Echtzeit-Metriken: activeUsers (Standard), screenPageViews, eventCount, keyEvents |
limitOptional | integer (1–1000) | — |
ga4_landing_pages
Lesen1 CreditsLandingpages mit Sitzungen, Sitzungen mit Interaktion, Schlüsselereignissen (Conversions), Umsatz und Conversion-Rate, standardmäßig nach Schlüsselereignissen sortiert.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–730) | Zeitfenster bis heute, wenn keine Daten angegeben sind (Standard 30) |
filtersOptional | array<object> | AND-verknüpfte Dimensionsfilter, z. B. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
with_query_stringOptional | boolean | — |
order_byOptional | keyEvents | sessions | engagedSessions | totalRevenue | — |
limitOptional | integer (1–1000) | — |
ga4_channel_report
Lesen1 CreditsSitzungen, Sitzungen mit Interaktion, Nutzer, Schlüsselereignisse (Conversions), Umsatz und Raten nach Standard-Channelgruppe (oder Quelle/Medium/Kampagne).
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
daysOptional | integer (1–730) | Zeitfenster bis heute, wenn keine Daten angegeben sind (Standard 30) |
filtersOptional | array<object> | AND-verknüpfte Dimensionsfilter, z. B. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'} |
dimensionOptional | string | sessionDefaultChannelGroup (Standard), sessionSource, sessionMedium, sessionCampaignName, sessionSourceMedium |
limitOptional | integer (1–1000) | — |
ga4_vs_google_ads
Lesen2 CreditsGA4 'Paid Search'-Channel (Sitzungen, Schlüsselereignisse, Umsatz) neben Google Ads Ausgaben, Klicks, Conversions und CPA für dasselbe Zeitfenster der letzten N Tage, mit der Attributionslücke. Ist Google Ads nicht verbunden, ist die Ads-Seite null mit einem Hinweis.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
daysOptional | integer (1–90) | — |
list_ga4_google_ads_links
Lesen1 CreditsMit der GA4 Property verknüpfte Google Ads Konten (Kundennummer, Personalisierungs-Kennzeichen, Ersteller, Erstellungszeit); linked=false kennzeichnet eine Property ohne Verknüpfung.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
list_ga4_conversion_events
Lesen1 CreditsAuf der Property definierte Conversion-(Schlüssel-)Ereignisse mit Zählmethode und Kennzeichen für benutzerdefiniert/löschbar.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
list_ga4_custom_dimensions
Lesen1 CreditsBenutzerdefinierte Dimensionen der Property (Parametername, Anzeigename, Umfang).
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
ga4_list_data_streams
Lesen1 CreditsDatenstreams einer GA4-Property (Web, Android, iOS) mit Stream-ID, Name, Standard-URI und bei Web-Streams der Mess-ID (G-XXXXXXX), die für ein GA4-Tag im Tag Manager benötigt wird. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4-Property-ID (Ziffern oder properties/123). Weglassen, um die verbundene Standard-Property zu nutzen; list_ga4_properties zeigt die Optionen. |
Schreib-Tools4 Tools
connect_ga4
Schreiben0 CreditsStartet die Verbindung mit Google Analytics 4: gibt einen einmaligen Autorisierungslink zurück, den der Nutzer öffnet (derselbe Ablauf wie connect_account). Bis zur Anmeldung des Nutzers wird nichts verbunden.
Dieses Tool hat keine Parameter.
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_ga4_conversion_event
Schreiben2 CreditsMarkiert ein GA4 Ereignis als Conversion (Schlüsselereignis). Erstellt ein Freigabeelement mit Vorschau; wird erst nach Freigabe und nur mit einem verbundenen Konto mit Bearbeitungszugriff über die Admin API angewendet.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
event_namePflicht | string | — |
counting_methodOptional | 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 CreditsErstellt eine benutzerdefinierte Dimension (Umfang Ereignis, Nutzer oder Artikel). Durchläuft Vorschau und Freigabe vor dem Aufruf der Admin API.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
parameter_namePflicht | string | — |
display_nameOptional | string | — |
scopeOptional | EVENT | USER | ITEM | — |
descriptionOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_ga4_google_ads_link
Schreiben2 CreditsVerknüpft ein Google Ads Konto mit der GA4 Property, damit Conversions an Google Ads fließen. Durchläuft Vorschau und Freigabe; erfordert Bearbeitungszugriff auf beiden Seiten.
| Parameter | Typ | Beschreibung |
|---|---|---|
property_idOptional | string | GA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen. |
customer_idPflicht | string | Google Ads Kundennummer, 123-456-7890 |
ads_personalizationOptional | boolean | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.