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 benötigten Daten ganz einfach aus der Google Ads API abrufen.

Vorteile

  • Nutzerfreundlichkeit:Vereinfacht das Schreiben von GAQL-Abfragen, ohne dass Sie die spezifische Syntax und die verfügbaren Felder kennen 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 befindet sich in der FROM-Klausel. 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 die SELECT-Klausel aufzunehmen. Während Sie Ihre Auswahl treffen, generiert das Tool dynamisch den entsprechenden GAQL-Abfragestring, zeigt Fehler an und filtert inkompatible Feldkombinationen heraus.
  3. Filter anwenden:Sie können WHERE-Klauselbedingungen hinzufügen, um die Ergebnisse zu filtern. Der Query Builder hilft Ihnen bei der Auswahl von Feldern, Operatoren und Werten und sorgt so für die richtige Syntax.
  4. Ergebnisse sortieren:Geben Sie mit der ORDER BY-Klausel Sortierreihenfolgen an.
  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 Feld kombinationen. Außerdem ist es mit dem API Explorer verknüpft, sodass Sie Ihre Abfrage anhand Ihrer Kontodaten testen können. Es gibt auch 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. Sie können entweder eine bestimmte Seite in der Referenzdokumentation für Berichte aufrufen oder die Übersichtsseite des Query Builders verwenden.

Ü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. Alternativ können Sie im linken Navigationsbereich direkt zur Ressource navigieren.
  2. Klicken Sie auf Hilfe beim Erstellen einer Abfrage, um zum Query Builder für diese bestimmte Ressource zu gelangen.

Ü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.

Integration mit anderen 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 API testen , um sie im API Explorer zu öffnen. Ihre Abfrage wird automatisch in den Anfragetext eingefügt. Sie können sie dann anhand Ihrer Kontodaten testen. Weitere Informationen zu diesem Tool finden Sie unter API Explorer.

Abfragevalidierung

Wenn Sie auf Abfrage eingeben oder bearbeiten klicken, wird die Abfragevalidierung geöffnet. Mit der Abfragevalidierung können Sie die Syntax Ihrer Abfrage validieren. Jede Abfrage, die vollständig mit dem Query Builder erstellt wurde, hat bereits die richtige Syntax. Wenn Sie sich jedoch mit der Ressource auskennen, die Sie abfragen, können Sie mit der Abfragevalidierung schnell eine Abfrage eingeben und ihre Gültigkeit prüfen. Weitere Informationen zu diesem Tool finden Sie unter Abfragevalidierung.