Diese Anleitung zeigt, wie du Google Ads an Claude Code anbindest, sodass Claude Kampagnen, Kosten, Suchbegriffe und Auktionsdaten direkt auswerten kann. Sie ist Teil einer Serie über das Anbinden von Marketing-Daten an Claude Code.

Google Ads hat von den vier Plattformen der Serie das etwas aufwändigste Setup, weil drei Dinge zusammenkommen: ein Developer Token, OAuth-Credentials und ein Refresh Token. Einmal eingerichtet, läuft es dann genauso reibungslos wie die anderen.

Wie es funktioniert

Wie bei den anderen Plattformen spricht Claude Code nicht direkt mit Google. Es schreibt ein Python-Script, das die offizielle Google Ads API abfragt und das Ergebnis als JSON speichert. Die Zugangsdaten liegen gebündelt in einer Datei namens google-ads.yaml.

Voraussetzungen

  • Zugriff auf das Google-Ads-Konto, das du auswerten willst.
  • Ein Google-Ads-Verwaltungskonto (MCC), denn nur dort lässt sich der Developer Token beantragen.
  • Python 3 und Claude Code installiert.
  • Ein Google-Cloud-Projekt.

Schritt 1: Developer Token beantragen

Der Developer Token ist der Schlüssel zur Google Ads API. Du beantragst ihn im Verwaltungskonto (MCC):

  1. Öffne das API Center deines Verwaltungskontos direkt über ads.google.com/aw/apicenter.
  2. Den Developer Token notieren.

Frisch erstellte Tokens haben zunächst nur “Test”-Zugriff, funktionieren also nur mit Testkonten. Für echte Konten brauchst du mindestens Basic Access. Den beantragst du im API Center über das Drop-down neben “Access level” mit “Apply for Basic Access”. Voraussetzung: eine gültige, regelmässig geprüfte API-Kontakt-E-Mail im API Center und alle aktiven Konten mit dem Verwaltungskonto verknüpft. Plane für die Freigabe einige Werktage ein.

Schritt 2: OAuth-Credentials in der Google Cloud Console

  1. Öffne die Google Cloud Console und wähle oder erstelle ein Projekt.
  2. Aktiviere die Google Ads API über die API-Library.
  3. Richte bei Bedarf die App im Bereich “Google Auth Platform” ein (früher “OAuth consent screen”): User Type External, eigene Mail als Test-User unter “Audience”.
  4. Lege im selben Bereich unter “Clients” einen OAuth-Client vom Typ Desktop app an. Du erhältst client_id und client_secret. Kopiere das client_secret direkt beim Erstellen, bei neueren Clients ist es danach nicht mehr einsehbar.

Schritt 3: Refresh Token erzeugen

Der Refresh Token erlaubt dem Script den dauerhaften Zugriff, ohne dass du dich jedes Mal neu einloggst. Am einfachsten geht das über den Google OAuth Playground mit dem Scope https://www.googleapis.com/auth/adwords. Claude Code kann dich durch diesen einmaligen Schritt führen.

Schritt 4: google-ads.yaml zusammensetzen

Alle Zugangsdaten kommen gebündelt in eine Datei google-ads.yaml, abgelegt ausserhalb des Projektordners:

developer_token: DEIN_DEVELOPER_TOKEN
client_id: DEINE_CLIENT_ID
client_secret: DEIN_CLIENT_SECRET
refresh_token: DEIN_REFRESH_TOKEN
login_customer_id: DEIN_MCC_KONTO   # optional, bei Zugriff über ein MCC
use_proto_plus: true

Empfohlener Ort:

~/.api-credentials/google-ads.yaml

Diese Datei enthält vollwertige Zugangsdaten und gehört niemals in git.

Schritt 5: Verbindung testen lassen

Das nötige Paket:

pip install google-ads

Ab hier übernimmt Claude Code. Du nennst die Customer ID des Kontos, das ist die zehnstellige Kontonummer oben rechts in Google Ads, und Claude schreibt das Abfrage-Script. Die Google Ads API wird über eine eigene Abfragesprache namens GAQL angesprochen. Auch die musst du nicht kennen, Claude formuliert die Abfragen.

Schritt 6: Claude Code die Auswertung überlassen

Sobald die Verbindung steht, fragst du in normaler Sprache:

  • “Zeig mir die Top-10-Kampagnen nach Kosten der letzten 14 Tage, mit Klicks, Conversions und CPA.”
  • “Welche Suchbegriffe haben Geld gekostet, aber keine Conversion gebracht?”
  • “Vergleiche die Kampagnen-Performance dieser Woche mit der Vorwoche und markiere die grössten Veränderungen.”

Claude schreibt für jede Frage die passende Abfrage, holt die Daten und wertet sie aus.

Sicherheit

  • google-ads.yaml bündelt mehrere Zugangsdaten in einer Datei. Ausserhalb des Repos ablegen, nie in git.
  • Die Google Ads API liest in dieser Konfiguration nur. Solange Claude reine Abfrage-Scripts schreibt, wird nichts verändert.
  • Zugriff entziehen: in der Cloud Console den OAuth-Client löschen oder den Refresh Token im Google-Account widerrufen.

Häufige Stolpersteine

  • Authentifizierungsfehler beim ersten Lauf: Refresh Token abgelaufen oder falsch. Über den OAuth Playground neu erzeugen.
  • Der Developer Token funktioniert nur mit einem Testkonto: Du hast noch Test-Zugriff. “Basic Access” im API Center beantragen.
  • Fehler rund um die login_customer_id: Beim Zugriff über ein MCC muss die MCC-Kontonummer als login_customer_id gesetzt sein. Die abgefragte Customer ID ist eine andere.
  • Kontonummer mit Bindestrichen: Die Customer ID gehört ohne Bindestriche ins Script, also 1234567890, nicht 123-456-7890.

Fazit

Das Setup hat drei Teile, das macht es etwas länger als bei den anderen Plattformen. Der Aufwand fällt aber nur einmal an. Danach beantwortet Claude Code Fragen zu Kosten, Suchbegriffen und Kampagnen in Sekunden. Den vollen Wert entfaltet das in Kombination mit GA4: Google Ads liefert die Kosten, GA4 die Conversions auf der Website.

Häufige Fragen

Warum brauche ich ein MCC-Verwaltungskonto?

Der Developer Token lässt sich nur in einem Verwaltungskonto beantragen. Hast du keines, kannst du kostenlos eines anlegen und dein Werbekonto damit verknüpfen.

Wie lange dauert die Freigabe des Developer Tokens?

Der Test-Zugriff steht sofort bereit. Die Freigabe für “Basic Access”, den du für echte Konten brauchst, kann einige Werktage dauern.

Kann Claude über diese Anbindung Kampagnen ändern?

Solange nur Abfrage-Scripts geschrieben werden, nicht. Die API könnte technisch auch schreiben, dafür müsste aber bewusst ein änderndes Script erstellt werden. Für Reporting bleibt es bei reinem Lesen.