Google Ads Query Validator

Der Google Ads Query Validator ist ein interaktives Tool, mit dem Entwickler Google Ads Query Language-Abfragen (GAQL) erstellen und überprüfen können, bevor sie in Anwendungen eingebunden werden. Sie können einen GAQL-Suchstring eingeben und erhalten sofort Feedback zur Gültigkeit. So lassen sich Syntaxfehler, Feldinkompatibilitäten und andere Probleme frühzeitig im Entwicklungsprozess erkennen.

Vorteile

  • Fehlervermeidung:Ungültige Anfragen werden frühzeitig erkannt, bevor sie in Anwendungen integriert werden. So werden Laufzeitfehler und fehlgeschlagene API-Aufrufe reduziert.
  • Schnellere Entwicklung:Ermöglicht schnelles Testen und Debuggen von GAQL-Anweisungen ohne den Aufwand vollständiger API-Anfrage- und Antwortzyklen.
  • GAQL-Einschränkungen verstehen:Hier erfahren Entwickler mehr über die komplexen Regeln dazu, welche Felder kompatibel sind und wie Ressourcen zueinander in Beziehung stehen.
  • Fehlerbehebung bei Anfragen:Wenn eine Anfrage ungültig ist, werden spezifische Fehlermeldungen ausgegeben, die oft detaillierter sind als ein allgemeiner API-Fehler. Manchmal werden auch gültige Alternativen vorgeschlagen.
  • Ressourceneffizienz:Unnötige API-Aufrufe mit Anfragen, die ohnehin fehlschlagen, werden vermieden.

Funktionsweise

Der Query Validator parst Ihre GAQL-Abfrage anhand des Schemas der Google Ads API und der in der Google Ads Query Language definierten Regeln. Zur Durchführung von Prüfungen werden Metadaten verwendet, von denen viele über GoogleAdsFieldService zugänglich sind. Dazu gehören:

  1. Syntax und Struktur:Die Abfrage muss der korrekten GAQL-Grammatik entsprechen, einschließlich der richtigen Verwendung und Reihenfolge von Klauseln wie SELECT, FROM, WHERE, ORDER BY und LIMIT.
  2. Gültigkeit von Feldern:Prüft, ob alle angegebenen Felder (Ressourcen, Segmente, Messwerte) vorhanden und richtig geschrieben sind.
  3. Ressourcenkompatibilität:Hier wird geprüft, ob die in der SELECT-Klausel ausgewählten Felder mit der in der FROM-Klausel angegebenen primären Ressource kompatibel sind.
  4. Segment- und Messwertkompatibilität:Hier wird geprüft, ob die Segmente und Messwerte, die in derselben Abfrage verwendet werden, miteinander und mit der Ressource in der FROM-Klausel kompatibel sind.
  5. Anforderungen an Klauseln:Validiert Regeln wie die Anforderung, dass bestimmte Felder, die in WHERE- oder ORDER BY-Klauseln verwendet werden, auch in der SELECT-Klausel vorhanden sein müssen.
  6. Verwendung von Operatoren:Prüft die korrekte Verwendung von Operatoren in den Bedingungen der WHERE-Klausel.

Wenn die Anfrage gültig ist, wird sie vom Tool bestätigt. Wenn Probleme gefunden werden, werden Fehlermeldungen angezeigt, die Ihnen helfen, das Problem zu ermitteln. Manchmal werden auch Vorschläge zur Behebung gemacht, z. B. kompatible Ressourcen für eine bestimmte Messwert.

Jetzt starten

So verwenden Sie die Google Ads-Abfragevalidierung:

  1. Rufen Sie die Abfragevalidierung auf.
  2. Geben Sie Ihre GAQL-Abfrage ein.
  3. Klicken Sie auf die Schaltfläche Abfrage validieren.
  4. Sehen Sie sich die Validierungsmeldung an, die unter dem Widget „Abfragevalidierung“ angezeigt wird. Eine Erfolgsmeldung gibt an, dass die Abfrage gültig ist. Andernfalls wird eine Fehlermeldung mit einer Beschreibung des Problems angezeigt. Die Fehlermeldungen helfen Ihnen, die Abfrage zu korrigieren. Bei einem Fehler aufgrund von Feldinkompatibilität werden möglicherweise alternative Ressourcen aufgeführt, die mit dem Messwert oder Segment, das Sie abfragen möchten, kompatibel sind.

Ausführlichere Erläuterungen zu GAQL-Konzepten und zur Validierung finden Sie auch in den GAQL-Videoanleitungen.