Google Ads API Developer Assistant 2.0

Donnerstag, 26. Februar 2026

Dieses wichtige Update verwandelt den Assistenten von einem leistungsstarken Tool zur Codegenerierung in einen proaktiven Partner für die Fehlerbehebung und Automatisierung für Google Ads-Entwickler. Seit der Veröffentlichung von Version 1.6.0 haben wir uns Ihr Feedback zu Herzen genommen und uns auf die schwierigsten Bereiche der API-Entwicklung konzentriert: Diagnose, Konsistenz und Einrichtung.

Was ist neu in Version 2.0?

1. Einfachere Installation und Wartung

Das Einrichten einer mehrsprachigen Entwicklungsumgebung sollte keine lästige Pflicht sein.

  • Einrichtung mit einem Befehl: Verwenden Sie das neue Flag --install-deps mit install.sh oder install.ps1, um pip-, composer- und bundler-Abhängigkeiten in einem Schritt zu verarbeiten.
  • Einheitliche Verzeichnisstruktur: Alle generierten Codes, CSV-Exporte und Diagnoseberichte sind jetzt in einem einzigen saved/-Verzeichnis mit Unterverzeichnissen für jeden Ausgabetyp organisiert.
  • Aktualisierung mit einem Befehl: Wenn eine neue Version der API und der Clientbibliotheken veröffentlicht wird, müssen Sie update.sh ausführen, um mit der aktuellen Version zu arbeiten. Sie können auch update.sh verwenden, um Ihrem Kontext zusätzliche Clientbibliotheken hinzuzufügen.

2. Fehlerbehebung bei agentischen Conversions

Das Offline-Conversion-Tracking ist eine der leistungsstärksten, aber auch komplexesten Funktionen der Google Ads API. Die Fehlersuche, warum eine Conversion nicht zugeordnet wurde, kann ein zeitaufwendiger manueller Prozess sein.

In Version 2.0 haben wir eine spezielle Suite für die Fehlerbehebung und Diagnose bei Conversions eingeführt.

  • Neues Script: api_examples/collect_conversions_troubleshooting_data.py
  • Neuer Befehl: /conversions_support_data

Das Script führt Standardberichte zur Fehlerbehebung bei Conversions aus und liefert dem Assistenten Kontext, um Ihre Probleme zu beheben.

Der Befehl ist am nützlichsten, nachdem der Assistent Ihr Conversion-Problem analysiert und versucht hat, es zu lösen. Wenn das nicht möglich ist und Sie den Support kontaktieren müssen, werden mit diesem Befehl Ihre Kundeneinstellungen, Conversion-Aktionen und Uploadzusammenfassungen analysiert, um einen strukturierten Diagnosebericht auf Grundlage der bereits durchgeführten Analyse zu erstellen. Es erkennt sogar automatisch „fehlerhafte“ Zustände und hohe Fehlerraten, sodass Sie sich stundenlanges Durchsuchen von Logs sparen können. Die Ergebnisse werden in einer Textdatei gespeichert, die Sie bei Bedarf einer Supportanfrage beifügen können.

3. Für die neueste API (v23) entwickelt

Version 2.0 unterstützt die Google Ads API v23 vollständig. Alle interaktiven Beispiele wurden aktualisiert und der interne Kontext des Assistenten ist jetzt für die neuesten Ressourcen und Felder optimiert, sodass der generierte Code produktionsreif ist.

4. Nahtlose Automatisierung mit Sitzungs-Hooks

Wir haben SessionStart- und SessionEnd-Hooks hinzugefügt, um Ihren Workflow wirklich reibungslos zu gestalten.

  • Automatische Konfiguration: Der Assistent kann jetzt zu Beginn einer Sitzung automatisch Ihre Konfigurationsdatei im Verzeichnis $HOME finden. Sie wird in das Unterverzeichnis „config“ in Ihrem Projektverzeichnis kopiert. Python ist die bevorzugte Sprache von Gemini für API-Abfragen. Wenn Sie also eine andere Sprache verwenden, wird Ihre Konfigurationsdatei gelesen und eine temporäre „google-ads.yaml“-Datei in der Konfiguration für die Abfragen erstellt. Die Antworten erfolgen jedoch weiterhin im Code Ihrer bevorzugten Sprache.
  • Automatische Bereinigung: Temporäre Konfigurationen werden beim Beenden sicher gelöscht, damit Ihr Arbeitsbereich sauber und Ihre Anmeldedaten geschützt bleiben.

5. Intelligentere GAQL-Validierung

Komplexe GAQL-Abfragen lassen sich jetzt einfacher denn je erstellen. Wir haben GEMINI.md und conversions/GEMINI.md mit strengen Validierungsregeln für die neuesten API-Grenzfälle aktualisiert, einschließlich einer verbesserten Verarbeitung von Datumssegmenten und Anforderungen an endliche Bereiche. Der Assistent erkennt Logikfehler jetzt, bevor Sie die Abfrage ausführen.

6. Fähigkeiten

Ein Skill ist wie ein Mini-Plug-in oder eine „Verhaltensvorlage“. Während der allgemeine Kontext (z. B. Ihre GEMINI.md-Datei) Hintergrundinformationen liefert, wird ein Skill nur dann in das „Gehirn“ der KI geladen, wenn sie eine komplexe, prozedurale Aufgabe ausführen muss, z. B. die aktuelle Version dieser Erweiterung abrufen. Du führst den Skill nicht direkt aus. Gemini entscheidet, wann es diese Informationen benötigt.

Obwohl es sich noch um eine experimentelle Funktion handelt, haben wir sie in diese Version aufgenommen, um die Verwendung von Hooks für die Sitzungsinitialisierung und -bereinigung zu ergänzen.

Warum sollten Sie ein Upgrade durchführen?

Der Sprung von Version 1.6.0 auf Version 2.0.0 ist mehr als nur ein Update mit neuen Funktionen. Es geht um Zuverlässigkeit. Durch die Kombination von umfassendem API-Wissen mit automatisierten Diagnosetools wird die „Trial-and-Error“-Schleife reduziert, die die API-Integration oft verlangsamt.

Egal, ob Sie Fehler bei Conversion-Uploads beheben oder komplexe Berichtspipelines erstellen möchten – mit Version 2.0 können Sie schneller und zuverlässiger arbeiten.

Einstieg

Erstinstallation

Upgrade von einer früheren Version durchführen

  • Kopieren Sie den benutzerdefinierten Code aus saved_code/ und saved_csv/ an einen sicheren Ort.
  • Löschen Sie Ihren lokalen Klon des Google Ads API Developer Assistant, indem Sie Ihr Projektverzeichnis und alle Unterverzeichnisse und Dateien löschen.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • Führen Sie im Projektverzeichnis „install.sh“ oder install.ps1 aus, um die Erweiterung und die Clientbibliotheken zu installieren.

Bob Hancock, Google Ads API-Team

Labels: google-ads-api, release