Google Ads Query Validator

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

Vorteile

  • Fehlervermeidung:Ungültige Abfragen werden frühzeitig erkannt, bevor sie in Anwendungen eingebunden werden. So lassen sich Laufzeitfehler und Fehler bei API-Aufrufen reduzieren.
  • Schnellere Entwicklung:Ermöglicht schnelles Testen und Debugging von GAQL-Anweisungen ohne den Aufwand vollständiger API-Anfrage- und Antwortzyklen.
  • GAQL-Einschränkungen verstehen:Entwickler können die komplexen Regeln dazu kennenlernen, welche Felder kompatibel sind und wie Ressourcen miteinander in Beziehung stehen.
  • Abfragen debuggen:Wenn eine Abfrage ungültig ist, werden spezifische Fehlermeldungen angezeigt, die oft detaillierter sind als ein allgemeiner API-Fehler. Manchmal werden auch gültige Alternativen vorgeschlagen.
  • Ressourceneffizienz:Unnötige API-Aufrufe mit Abfragen, die ohnehin fehlschlagen, werden vermieden.

Funktionsweise

Der Abfragevalidator analysiert Ihre GAQL-Abfrage anhand des Schemas der Google Ads API und der Regeln, die in der Google Ads Query Language definiert sind. Dabei werden Metadaten verwendet, von denen viele über GoogleAdsFieldService zugänglich sind. Folgende Prüfungen werden durchgeführt:

  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:Es wird geprüft, ob alle angegebenen Felder (Ressourcen, Segmente, Messwerte) vorhanden und richtig geschrieben sind.
  3. Kompatibilität von Ressourcen:Es wird geprüft, ob die in der Klausel SELECT ausgewählten Felder mit der in der Klausel FROM angegebenen primären Ressource kompatibel sind.
  4. Kompatibilität von Segmenten und Messwerten:Stellt sicher, dass 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:Es werden Regeln wie die Anforderung validiert, dass bestimmte Felder, die in den Klauseln WHERE oder ORDER BY verwendet werden, auch in der Klausel SELECT vorhanden sein müssen.
  6. Verwendung von Operatoren:Es wird geprüft, ob die Operatoren in den Bedingungen der Klausel WHERE korrekt verwendet werden.

Wenn die Abfrage gültig ist, wird dies vom Tool bestätigt. Wenn Probleme gefunden werden, werden Fehlermeldungen angezeigt, die helfen, das Problem zu identifizieren. Manchmal werden auch Vorschläge zur Behebung angeboten, z. B. kompatible Ressourcen für einen bestimmten Messwert.

Jetzt starten

So verwenden Sie den Google Ads-Abfragevalidator:

  1. Rufen Sie den Abfragevalidator auf.
  2. Geben Sie Ihre GAQL-Abfrage ein.
  3. Klicken Sie auf die Schaltfläche Abfrage validieren.
  4. Prüfen Sie die Validierungsnachricht, die unter dem Widget des Abfragevalidators angezeigt wird. Eine Erfolgsmeldung bedeutet, dass die Abfrage gültig ist. Andernfalls wird eine Fehlermeldung angezeigt, in der das Problem beschrieben wird. Die Fehlermeldungen helfen Ihnen, die Abfrage zu korrigieren. Bei einem Fehler aufgrund einer Inkompatibilität von Feldern werden beispielsweise alternative Ressourcen aufgeführt, die mit dem Messwert oder Segment kompatibel *sind*, den Sie abfragen möchten.

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