ComposioHQ/googleads-automation

Google Ads-Automatisierung über Rube MCP

Greifen Sie über die Google Analytics-Integration auf Google Ads-Daten zu, führen Sie Leistungsberichte aus, listen Sie verknüpfte Ads-Konten auf und analysieren Sie 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 Toolkit google_analytics
• Rufen Sie immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Tool-Schemata zu erhalten

Einrichtung

Rube MCP einbinden: Fügen Sie https://rube.app/mcp als MCP-Server in Ihrer Client-Konfiguration hinzu. Es werden keine API-Schlüssel benötigt – fügen Sie einfach den Endpunkt hinzu und es funktioniert.

1. Stellen Sie sicher, dass Rube MCP verfügbar ist, indem Sie bestätigen, dass RUBE_SEARCH_TOOLS antwortet
2. Rufen Sie RUBE_MANAGE_CONNECTIONS mit Toolkit google_analytics auf
3. Falls die Verbindung nicht AKTIV ist, folgen Sie dem zurückgegebenen Authentifizierungslink, um die Einrichtung abzuschließen
4. Bestätigen Sie den Verbindungsstatus zeigt AKTIV an, bevor Sie Workflows ausführen

Hinweis: Google Ads-Daten werden über die Google Analytics-Toolkit-Integration abgerufen. Die unten stehenden Tools verwenden GA4-Eigenschaften, die mit Google Ads-Konten verknüpft sind.

Kern-Workflows

1. Google Ads-Links für eine Eigenschaft auflisten

Verwenden Sie GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS, um alle Google Ads-Kontenlinks abzurufen, die für eine GA4-Eigenschaft konfiguriert sind.

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

2. Einen GA4-Leistungsbericht ausführen

Verwenden Sie GOOGLE_ANALYTICS_RUN_REPORT, um benutzerdefinierte Berichte mit Dimensionen, Metriken, Datumsbereichen und Filtern auszuführen.

Tool: GOOGLE_ANALYTICS_RUN_REPORT
Parameter:
  - property (erforderlich): Ressourcenname der Eigenschaft (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

Verwenden Sie GOOGLE_ANALYTICS_CHECK_COMPATIBILITY, um Dimensions- und Metrik-Kombinationen vor der Ausführung eines Berichts zu validieren.

Tool: GOOGLE_ANALYTICS_CHECK_COMPATIBILITY
Beschreibung: Validiert die Kompatibilität ausgewählter Dimensionen oder Metriken
  vor der Ausführung eines Berichts.
Hinweis: Rufen Sie RUBE_SEARCH_TOOLS auf, um das vollständige Schema für dieses Tool zu erhalten.

4. GA4-Konten auflisten

Verwenden Sie GOOGLE_ANALYTICS_LIST_ACCOUNTS, um alle zugänglichen Google Analytics-Konten aufzuzählen.

Tool: GOOGLE_ANALYTICS_LIST_ACCOUNTS
Parameter:
  - pageSize: Maximale Anzahl zurückzugebender Konten
  - pageToken: Paginierungs-Token
  - showDeleted: Weich gelöschte Konten einschließen

5. GA4-Eigenschaften unter einem Konto auflisten

Verwenden Sie GOOGLE_ANALYTICS_LIST_PROPERTIES, um Eigenschaften für ein bestimmtes GA4-Konto aufzulisten.

Tool: GOOGLE_ANALYTICS_LIST_PROPERTIES
Parameter:
  - account (erforderlich): Ressourcenname des Kontos (Format: "accounts/{account_id}")
  - pageSize: Maximale Eigenschaften (1-200)
  - pageToken: Paginierungs-Token
  - showDeleted: Gelöschte Eigenschaften einschließen

6. Verfügbare Dimensionen und Metriken abrufen

Verwenden Sie GOOGLE_ANALYTICS_GET_METADATA, um alle verfügbaren Felder für die Erstellung von Berichten zu entdecken.

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

Häufige Muster

• Entdecken, dann berichten: Verwenden Sie GOOGLE_ANALYTICS_LIST_ACCOUNTS, um Konto-IDs zu finden, dann GOOGLE_ANALYTICS_LIST_PROPERTIES, um Eigenschafts-IDs zu finden, dann GOOGLE_ANALYTICS_RUN_REPORT, um Daten abzurufen.
• Vor dem Abfragen validieren: Verwenden Sie GOOGLE_ANALYTICS_CHECK_COMPATIBILITY, um Dimensions-/Metrik-Kombinationen zu validieren, bevor Sie Berichte ausführen, um 400-Fehler zu vermeiden.
• Kampagnenleistung: Führen Sie Berichte mit Dimensionen wie sessionCampaignName, sessionSource, sessionMedium und Metriken wie sessions, activeUsers, totalRevenue aus.
• Ads-Link-Erkennung: Verwenden Sie GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS, um herauszufinden, welche Google Ads-Konten mit jeder GA4-Eigenschaft verknüpft sind.
• Felderkennung: Verwenden Sie GOOGLE_ANALYTICS_GET_METADATA, um alle verfügbaren Dimensionen und Metriken aufzulisten, bevor Sie komplexe Berichte erstellen.

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ügen Sie dateRange nicht ins Dimensionen-Array ein. Verwenden Sie stattdessen date, dateHour, year, month oder week.
• exits ist NICHT gültig: Weder exits als Dimension noch als Metrik ist in GA4 gültig.
• Eigenschafts-ID-Format: Muss properties/{numeric_id} sein (z.B. properties/123456789). Verwenden Sie keine Google-Konto-IDs (lange OAuth-IDs).
• Konto-ID-Format: Muss accounts/{numeric_id} sein, wobei die numerische ID 6-10 Stellen hat.
• Filter-Trennung: Verwenden Sie 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.

Kurzreferenz

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

---

Bereitgestellt von Composio