googleads-automation

Google Ads-Automatisierung über Rube MCP

Greife auf Google Ads-Daten über die Google Analytics-Integration zu, erstelle Performanceberichte, liste verknüpfte Ads-Konten und analysiere Kampagnenmetriken mit Rube MCP (Composio).

Toolkit-Dokumentation: composio.dev/toolkits/googleads

Voraussetzungen

• Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
• Aktive Verbindung über RUBE_MANAGE_CONNECTIONS mit dem Toolkit google_analytics
• Rufe immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Tool-Schemas zu erhalten

Einrichtung

Rube MCP installieren: Füge https://rube.app/mcp als MCP-Server in deiner Client-Konfiguration hinzu. Keine API-Schlüssel erforderlich – einfach den Endpunkt hinzufügen und es funktioniert.

1. Überprüfe, ob Rube MCP verfügbar ist, indem du bestätigst, dass RUBE_SEARCH_TOOLS antwortet
2. Rufe RUBE_MANAGE_CONNECTIONS mit dem Toolkit google_analytics auf
3. Wenn die Verbindung nicht AKTIV ist, folge dem zurückgegebenen Authentifizierungslink, um die Einrichtung abzuschließen
4. Bestätige, dass der Verbindungsstatus AKTIV ist, bevor du Workflows ausführst

Hinweis: Auf Google Ads-Daten wird über die Google Analytics-Toolkit-Integration zugegriffen. Die unten aufgeführten Tools verwenden GA4-Properties, die mit Google Ads-Konten verknüpft sind.

Kern-Workflows

1. Google Ads-Verknüpfungen für eine Property auflisten

Verwende GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS, um alle für eine GA4-Property konfigurierten Google Ads-Kontoverknüpfungen abzurufen.

Tool: GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS
Parameter:
  - parent (erforderlich): Ressourcenname der Property (Format: "properties/{propertyId}")
  - pageSize: Maximale Ergebnisse (1-200, Standard 50)
  - pageToken: Paginierungstoken

2. Einen GA4-Performancebericht erstellen

Verwende GOOGLE_ANALYTICS_RUN_REPORT, um benutzerdefinierte Berichte mit Dimensionen, Metriken, Datumsbereichen und Filtern zu erstellen.

Tool: GOOGLE_ANALYTICS_RUN_REPORT
Parameter:
  - property (erforderlich): Ressource der Property (Format: "properties/{property_id}")
  - dimensions: Array von Dimensionsobjekten (z.B. [{"name": "sessionCampaignName"}, {"name": "date"}])
  - metrics: Array von Metrikobjekten (z.B. [{"name": "sessions"}, {"name": "totalRevenue"}])
  - dateRanges: Array mit startDate und endDate (z.B. [{"startDate": "2025-01-01", "endDate": "2025-01-31"}])
  - dimensionFilter: Filter nach Dimensionswerten
  - metricFilter: Filter nach Metrikwerten (wird nach der Aggregation angewendet)
  - orderBys: Ergebnisse sortieren
  - limit: Maximale Anzahl zurückzugebender Zeilen (1-250000)

3. Dimensions-/Metrik-Kompatibilität prüfen

Verwende GOOGLE_ANALYTICS_CHECK_COMPATIBILITY, um Dimensions- und Metrikkombinationen zu validieren, bevor du einen Bericht erstellst.

Tool: GOOGLE_ANALYTICS_CHECK_COMPATIBILITY
Beschreibung: Validiert die Kompatibilität ausgewählter Dimensionen oder Metriken,
  bevor ein Bericht erstellt wird.
Hinweis: Rufe RUBE_SEARCH_TOOLS auf, um das vollständige Schema für dieses Tool zu erhalten.

4. GA4-Konten auflisten

Verwende GOOGLE_ANALYTICS_LIST_ACCOUNTS, um alle zugänglichen Google Analytics-Konten aufzulisten.

Tool: GOOGLE_ANALYTICS_LIST_ACCOUNTS
Parameter:
  - pageSize: Maximale Anzahl zurückzugebender Konten
  - pageToken: Paginierungstoken
  - showDeleted: Weich gelöschte Konten einbeziehen

5. GA4-Properties unter einem Konto auflisten

Verwende GOOGLE_ANALYTICS_LIST_PROPERTIES, um Properties für ein bestimmtes GA4-Konto aufzulisten.

Tool: GOOGLE_ANALYTICS_LIST_PROPERTIES
Parameter:
  - account (erforderlich): Ressourcenname des Kontos (Format: "accounts/{account_id}")
  - pageSize: Maximale Properties (1-200)
  - pageToken: Paginierungstoken
  - showDeleted: Gelöschte Properties einbeziehen

6. Verfügbare Dimensionen und Metriken abrufen

Verwende GOOGLE_ANALYTICS_GET_METADATA, um alle verfügbaren Felder für die Berichterstellung zu entdecken.

Tool: GOOGLE_ANALYTICS_GET_METADATA
Beschreibung: Ruft Metadaten für Dimensionen, Metriken und Vergleiche
  für eine GA4-Property ab.
Hinweis: Rufe RUBE_SEARCH_TOOLS auf, um das vollständige Schema für dieses Tool zu erhalten.

Häufige Muster

• Entdecken, dann berichten: Verwende GOOGLE_ANALYTICS_LIST_ACCOUNTS, um Konten-IDs zu finden, dann GOOGLE_ANALYTICS_LIST_PROPERTIES, um Property-IDs zu finden, dann GOOGLE_ANALYTICS_RUN_REPORT, um Daten abzurufen.
• Vor der Abfrage validieren: Verwende GOOGLE_ANALYTICS_CHECK_COMPATIBILITY, um Dimensions-/Metrik-Kombinationen zu validieren, bevor du Berichte erstellst, um 400-Fehler zu vermeiden.
• Kampagnen-Performance: Erstelle Berichte mit Dimensionen wie sessionCampaignName, sessionSource, sessionMedium und Metriken wie sessions, activeUsers, totalRevenue.
• Ads-Verknüpfungen entdecken: Verwende GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS, um herauszufinden, welche Google Ads-Konten mit jeder GA4-Property verknüpft sind.
• Feld-Entdeckung: Verwende GOOGLE_ANALYTICS_GET_METADATA, um alle verfügbaren Dimensionen und Metriken aufzulisten, bevor du komplexe Berichte erstellst.

Bekannte Fallstricke

• Dimensions-/Metrik-Kompatibilität: Die GA4-API hat strenge Kompatibilitätsregeln. Nicht alle Dimensionen können mit allen Metriken kombiniert werden. Demografische Dimensionen (z.B. userAgeBracket, userGender) sind oft inkompatibel mit sitzungsbezogenen Dimensionen/Filtern (z.B. sessionCampaignName, sessionSource).
• dateRange ist KEINE Dimension: Füge dateRange nicht in das Dimensions-Array ein. Verwende stattdessen date, dateHour, year, month oder week.
• exits ist NICHT gültig: Weder exits als Dimension noch als Metrik ist in GA4 gültig.
• Property-ID-Format: Muss properties/{numerische_id} sein (z.B. properties/123456789). Verwende keine Google-Konto-IDs (lange OAuth-IDs).
• Konto-ID-Format: Muss accounts/{numerische_id} sein, wobei die numerische ID 6-10 Ziffern lang ist.
• Filtertrennung: Verwende dimensionFilter nur für Dimensionsfelder und metricFilter nur für Metrikfelder. Die Vermischung führt zu Fehlern.
• Maximal 9 Dimensionen und 10 Metriken pro Berichtsanfrage.

Kurzübersicht

Aktion	Tool	Wichtige Parameter
Ads-Verknüpfungen auflisten	GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS	parent
Bericht erstellen	GOOGLE_ANALYTICS_RUN_REPORT	property, dimensions, metrics, dateRanges
Kompatibilität prüfen	GOOGLE_ANALYTICS_CHECK_COMPATIBILITY	(vollständiges Schema über RUBE_SEARCH_TOOLS)
Konten auflisten	GOOGLE_ANALYTICS_LIST_ACCOUNTS	pageSize
Properties auflisten	GOOGLE_ANALYTICS_LIST_PROPERTIES	account, pageSize
Metadaten abrufen	GOOGLE_ANALYTICS_GET_METADATA	(vollständiges Schema über RUBE_SEARCH_TOOLS)

---

Powered by Composio