Zum Inhalt springen
Tecrübetecrube.com
Assistenten-Tools · Berichte

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 Credits

GA4 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 Credits

Benutzerdefinierter 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.

ParameterTypBeschreibung
property_idOptionalstringGA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen.
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
daysOptionalinteger (1–730)Zeitfenster bis heute, wenn keine Daten angegeben sind (Standard 30)
metricsOptionalarray<string>Metriknamen der GA4 Data API, Standard [sessions, totalUsers, keyEvents]
dimensionsOptionalarray<string>GA4 Dimensionsnamen, z. B. sessionDefaultChannelGroup, landingPage, date, country, deviceCategory, eventName
filtersOptionalarray<object>AND-verknüpfte Dimensionsfilter, z. B. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
order_byOptionalstringeine Metrik oder Dimension aus der Anfrage
orderOptionalasc | desc—
limitOptionalinteger (1–10000)—
offsetOptionalinteger (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.

ParameterTypBeschreibung
property_idOptionalstringGA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen.
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
daysOptionalinteger (1–730)Zeitfenster bis heute, wenn keine Daten angegeben sind (Standard 30)
compare_previousOptionalboolean—
all_propertiesOptionalbooleantrue: 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 Credits

Aktive Nutzer gerade jetzt (letzte 30 Minuten) und wo sie sich befinden — standardmäßig nach Seiten-/Bildschirmtitel.

ParameterTypBeschreibung
property_idOptionalstringGA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen.
dimensionsOptionalarray<string>Echtzeit-Dimensionen: unifiedScreenName (Standard), country, city, deviceCategory, eventName, platform
metricsOptionalarray<string>Echtzeit-Metriken: activeUsers (Standard), screenPageViews, eventCount, keyEvents
limitOptionalinteger (1–1000)—

ga4_landing_pages

Lesen1 Credits

Landingpages mit Sitzungen, Sitzungen mit Interaktion, Schlüsselereignissen (Conversions), Umsatz und Conversion-Rate, standardmäßig nach Schlüsselereignissen sortiert.

ParameterTypBeschreibung
property_idOptionalstringGA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen.
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
daysOptionalinteger (1–730)Zeitfenster bis heute, wenn keine Daten angegeben sind (Standard 30)
filtersOptionalarray<object>AND-verknüpfte Dimensionsfilter, z. B. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
with_query_stringOptionalboolean—
order_byOptionalkeyEvents | sessions | engagedSessions | totalRevenue—
limitOptionalinteger (1–1000)—

ga4_channel_report

Lesen1 Credits

Sitzungen, Sitzungen mit Interaktion, Nutzer, Schlüsselereignisse (Conversions), Umsatz und Raten nach Standard-Channelgruppe (oder Quelle/Medium/Kampagne).

ParameterTypBeschreibung
property_idOptionalstringGA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen.
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
daysOptionalinteger (1–730)Zeitfenster bis heute, wenn keine Daten angegeben sind (Standard 30)
filtersOptionalarray<object>AND-verknüpfte Dimensionsfilter, z. B. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
dimensionOptionalstringsessionDefaultChannelGroup (Standard), sessionSource, sessionMedium, sessionCampaignName, sessionSourceMedium
limitOptionalinteger (1–1000)—

ga4_vs_google_ads

Lesen2 Credits

GA4 '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.

ParameterTypBeschreibung
property_idOptionalstringGA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen.
daysOptionalinteger (1–90)—

list_ga4_conversion_events

Lesen1 Credits

Auf der Property definierte Conversion-(Schlüssel-)Ereignisse mit Zählmethode und Kennzeichen für benutzerdefiniert/löschbar.

ParameterTypBeschreibung
property_idOptionalstringGA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen.

list_ga4_custom_dimensions

Lesen1 Credits

Benutzerdefinierte Dimensionen der Property (Parametername, Anzeigename, Umfang).

ParameterTypBeschreibung
property_idOptionalstringGA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen.

ga4_list_data_streams

Lesen1 Credits

Datenstreams 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.

ParameterTypBeschreibung
property_idOptionalstringGA4-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 Credits

Startet 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 Credits

Markiert 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.

ParameterTypBeschreibung
property_idOptionalstringGA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen.
event_namePflichtstring—
counting_methodOptionalONCE_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

Erstellt eine benutzerdefinierte Dimension (Umfang Ereignis, Nutzer oder Artikel). Durchläuft Vorschau und Freigabe vor dem Aufruf der Admin API.

ParameterTypBeschreibung
property_idOptionalstringGA4 Property-ID (Ziffern oder properties/123). Weglassen, um den verbundenen Standard zu verwenden; list_ga4_properties zeigt die Optionen.
parameter_namePflichtstring—
display_nameOptionalstring—
scopeOptionalEVENT | USER | ITEM—
descriptionOptionalstring—

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