Google Ads Query Builder

Der Google Ads Query Builder ist ein interaktives Tool, mit dem Sie Abfragen mit der Google Ads Query Language (GAQL) interaktiv erstellen und validieren können. Ganz gleich, ob Sie GAQL-Neuling oder erfahrener Nutzer sind: Mit dem Query Builder können Sie den Prozess des Abrufens der benötigten Daten aus der Google Ads API vereinfachen.

Vorteile

  • Nutzerfreundlichkeit:Der Prozess des Schreibens von GAQL-Abfragen wird vereinfacht, ohne dass Sie mit der spezifischen Syntax und den verfügbaren Feldern vertraut sein müssen.
  • Auffindbarkeit:Hier können Sie verfügbare Ressourcen, Felder, Segmente und Messwerte im Google Ads API-Datenmodell suchen und finden.
  • Weniger Fehler:Durch die strukturierte Benutzeroberfläche und die Drop-down-Menüs mit gültigen Optionen werden Syntax- und Tippfehler vermieden und die generierte Abfrage ist gültig.
  • Schnellere Erstellung von Abfragen:Der Entwicklungsprozess wird beschleunigt, da die Generierung von Abfragestrings automatisiert wird.
  • Validierung:Das Tool ist mit dem API Explorer und dem Query Validator verknüpft, um Abfragen vor der Ausführung anhand von API-Regeln zu prüfen.

Funktionsweise

Der Google Ads Query Builder bietet eine benutzerfreundliche Oberfläche, mit der Sie GAQL-Abfragen visuell zusammenstellen können. So funktioniert es:

  1. Ressource auswählen:Wählen Sie zuerst auf dem Tab Referenz die primäre Ressource für die Version aus, die Sie abfragen möchten. Diese Ressource wird in der Klausel FROM enthalten sein. Ressourcen stellen Entitäten in Google Ads dar, z. B. campaign, ad_group oder keyword_view. Der Builder listet alle verfügbaren Ressourcen auf.
  2. Felder auswählen:Wenn eine Ressource ausgewählt ist, werden alle auswählbaren Felder angezeigt, einschließlich Attributen, Segmenten und Messwerten, die sich auf diese Ressource und ihre zugehörigen (implizit verknüpfbaren) Ressourcen beziehen. Sie können Kästchen anklicken, um Felder in Ihre SELECT-Klausel aufzunehmen. Während Sie Auswahlen treffen, generiert das Tool dynamisch den entsprechenden GAQL-Abfragestring, zeigt alle Fehler an und filtert inkompatible Feldkombinationen heraus.
  3. Filter anwenden:Sie können WHERE-Klauselbedingungen hinzufügen, um die Ergebnisse zu filtern. Der Builder hilft Ihnen bei der Auswahl von Feldern, Operatoren und Werten und sorgt so für eine korrekte Syntax.
  4. Ergebnisse sortieren:Mit der ORDER BY-Klausel können Sie Sortierreihenfolgen angeben.
  5. Grenzwerte festlegen:Fügen Sie eine LIMIT-Klausel hinzu, um die Anzahl der zurückgegebenen Ergebnisse zu steuern.
  6. Validieren:Das Tool führt Sie automatisch zu gültigen Feldkombinationen. Außerdem wird auf den API Explorer verlinkt, damit Sie Ihre Abfrage anhand Ihrer Kontodaten testen können. Außerdem gibt es einen separaten [Abfragevalidator](link to page), in den Sie manuell geschriebene GAQL-Abfragen einfügen und prüfen können.
  7. Exportieren:Wenn Sie mit Ihrer Abfrage zufrieden sind, kopieren Sie den getesteten, syntaktisch korrekten GAQL-String und fügen Sie ihn in Ihre GoogleAdsService.Search- oder SearchStream-Clientanfragen ein.

Der Builder sorgt dafür, dass die ausgewählten Felder, Segmente und Messwerte kompatibel sind und in einer einzelnen Abfrage verwendet werden können. Dabei wird auf die zugrunde liegenden Metadaten der Google Ads API verwiesen.

Jetzt starten

Es gibt zwei Möglichkeiten, auf den Query Builder zuzugreifen. Sie können entweder eine bestimmte Seite in der Dokumentation zur Berichterstellung aufrufen oder die Übersichtseite des Query Builders verwenden.

Aus der Referenzdokumentation für Berichte

  1. Beginnen Sie mit der Dokumentation zu Berichten und wählen Sie in der Liste aller Ressourcen eine bestimmte Ressource aus. Alternativ können Sie auch direkt über den linken Navigationsbereich zur Ressource wechseln.
  2. Klicken Sie auf Hilfe beim Erstellen einer Abfrage. Sie werden dann zum Query Builder für die jeweilige Ressource weitergeleitet.

Über die Übersichtsseite von Query Builder

Rufen Sie in der Dokumentation zur Berichterstellung den Abschnitt Query Builder auf und wählen Sie die Ressource aus, die Sie untersuchen möchten.

Einbindung in andere Tools

Der Query Builder ist in andere Tools im Google Ads API Developer Toolkit eingebunden. Sie können eine im Query Builder erstellte Abfrage im API Explorer testen oder mit dem Query Validator validieren.

API Explorer

Wenn Sie Ihre Anfrage erstellt haben, klicken Sie auf Im API Explorer testen, um die Anfrage im API Explorer zu öffnen. Ihre Abfrage wird automatisch in den Anfragetext eingefügt. Anschließend können Sie sie testen, indem Sie sie für Ihre Kontodaten ausführen. Weitere Informationen zu diesem Tool finden Sie unter API Explorer.

Abfragevalidierung

Wenn Sie auf Abfrage eingeben oder bearbeiten klicken, wird der Query Validator geöffnet. Verwenden Sie die Abfragevalidierung, um die Syntax Ihrer Abfrage zu validieren. Für alle Abfragen, die vollständig mit dem Abfragegenerator erstellt wurden, ist die Syntax bereits korrekt. Wenn Sie sich jedoch mit der Ressource, die Sie abfragen, gut auskennen, können Sie mit dem Abfragevalidator schnell eine Abfrage eingeben und ihre Gültigkeit prüfen. Weitere Informationen zu diesem Tool finden Sie unter Query Validator.