Google Ads Query Builder

Der Google Ads Query Builder ist ein interaktives Tool, mit dem Sie Abfragen mit der Google Ads Query Language (GAQL) erstellen und validieren können. Egal, ob Sie GAQL-Neuling oder erfahrener Nutzer sind, mit dem Query Builder können Sie die genauen Daten, die Sie von der Google Ads API benötigen, ganz einfach abrufen.

Vorteile

  • Nutzerfreundlichkeit:Vereinfacht das Schreiben von GAQL-Abfragen, ohne dass Sie mit der spezifischen Syntax und den verfügbaren Feldern vertraut sein müssen.
  • Auffindbarkeit:Hilft Ihnen, verfügbare Ressourcen, Felder, Segmente und Messwerte im Datenmodell der Google Ads API zu finden.
  • Weniger Fehler:Durch eine strukturierte Oberfläche und Drop-down-Menüs mit gültigen Optionen werden Syntaxfehler und Tippfehler vermieden und die generierte Abfrage ist gültig.
  • Schnellere Abfrageerstellung:Beschleunigt den Entwicklungsprozess durch die Automatisierung der Generierung von Abfragestrings.
  • Validierung:Das Tool ist mit dem API Explorer und der Abfragevalidierung verknüpft, um Abfragen vor der Ausführung anhand der API-Regeln zu prüfen.

Funktionsweise

Der Google Ads Query Builder bietet eine nutzerfreundliche Oberfläche, mit der Sie GAQL-Abfragen visuell zusammenstellen können. Der generelle Ablauf:

  1. Ressource auswählen: Wählen Sie zuerst die primäre Ressource auf dem Tab „Referenz“ für die Version aus, die Sie abfragen möchten. Diese Ressource wird in die FROM-Klausel eingefügt. Ressourcen stellen Entitäten in Google Ads dar, z. B. campaign, ad_group oder keyword_view. Im Query Builder werden alle verfügbaren Ressourcen aufgeführt.
  2. Felder auswählen:Nachdem Sie eine Ressource ausgewählt haben, werden alle auswählbaren Felder angezeigt, einschließlich Attribute, Segmente und Messwerte, die mit dieser Ressource und ihren zugehörigen (implizit verknüpfbaren) Ressourcen verknüpft sind. Sie können die Kästchen anklicken, um Felder in Ihre SELECT-Klausel aufzunehmen. Während Sie Ihre Auswahl treffen, generiert das Tool dynamisch den entsprechenden GAQL-Abfragestring, zeigt alle Fehler an und filtert inkompatible Feldkombinationen heraus.
  3. Filter anwenden:Fügen Sie WHERE-Klauselbedingungen hinzu, um die Ergebnisse zu filtern. Der Query Builder hilft Ihnen bei der Auswahl von Feldern, Operatoren und Werten und sorgt für die richtige Syntax.
  4. Ergebnisse sortieren:Geben Sie mit der ORDER BY-Klausel die Sortierreihenfolge an.
  5. Limits festlegen:Fügen Sie eine LIMIT-Klausel hinzu, um die Anzahl der zurückgegebenen Ergebnisse zu begrenzen.
  6. Validieren: Das Tool führt Sie automatisch zu gültigen Feld kombinationen und verlinkt auch zum API Explorer, damit Sie Ihre Abfrage mit Ihren Kontodaten testen können. Außerdem gibt es eine separate Abfragevalidierung, in die 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 Query Builder sorgt dafür, dass die ausgewählten Felder, Segmente und Messwerte kompatibel sind und in einer einzigen Abfrage verwendet werden können. Dabei werden die zugrunde liegenden Metadaten der Google Ads API verwendet.

Jetzt starten

Es gibt zwei Möglichkeiten, den Query Builder aufzurufen: über eine bestimmte Seite in der Referenzdokumentation für Berichte oder über die Übersichtsseite des Query Builders.

Über die Referenzdokumentation für Berichte

  1. Rufen Sie die Referenzdokumentation für Berichte auf und wählen Sie in der Liste aller Ressourcen eine bestimmte Ressource aus, mit der Sie beginnen möchten. Alternativ können Sie im linken Navigationsbereich direkt zur Ressource navigieren.
  2. Klicken Sie auf Hilfe beim Erstellen einer Abfrage. Sie werden zum Query Builder für diese bestimmte Ressource weitergeleitet.

Über die Übersichtsseite des Query Builders

Rufen Sie den Abschnitt „Query Builder“ der Referenzdokumentation für Berichte 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 der Abfragevalidierung validieren.

API Explorer

Nachdem Sie Ihre Abfrage erstellt haben, klicken Sie auf Im API Explorer testen , um sie im API Explorer zu öffnen. Ihre Abfrage wird automatisch in den Anfragetext eingefügt. Sie können sie dann testen, indem Sie sie mit Ihren Kontodaten ausführen. Weitere Informationen zu diesem Tool finden Sie unter API Explorer.

Abfragevalidierung

Wenn Sie auf Abfrage eingeben oder bearbeiten klicken, wird die Abfragevalidierung geöffnet. Verwenden Sie die Abfragevalidierung, um die Syntax Ihrer Abfrage zu validieren. Jede Abfrage, die vollständig über den Query Builder erstellt wurde, hat bereits die richtige Syntax. Wenn Sie jedoch mit der Ressource vertraut sind, die Sie abfragen, bietet die Abfragevalidierung eine schnelle Möglichkeit, eine Abfrage einzugeben und ihre Gültigkeit zu prüfen. Weitere Informationen zu diesem Tool finden Sie unter Abfragevalidierung.