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. Unabhängig davon, ob Sie neu bei GAQL oder ein erfahrener Nutzer sind, kann der Query Builder den Prozess des Abrufens der genauen Daten, die Sie von der Google Ads API benötigen, vereinfachen.

Vorteile

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

Funktionsweise

Der Google Ads Query Builder bietet eine nutzerfreundliche Oberfläche, auf 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 der FROM-Klausel platziert. 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: Nachdem eine Ressource ausgewählt wurde, werden im Tool alle auswählbaren Felder angezeigt, einschließlich Attributen, Segmenten und Messwerten, die sich auf diese Ressource und die ihr zugeordneten (implizit verknüpfbaren) Ressourcen beziehen. Sie können 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: Fügen Sie WHERE-Klauselbedingungen hinzu, um die Ergebnisse zu filtern. Der Builder hilft Ihnen bei der Auswahl von Feldern, Operatoren und Werten und sorgt für die richtige Syntax.
  4. Ergebnisse sortieren: Geben Sie die Sortierreihenfolge mit der ORDER BY-Klausel an.
  5. Limits 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 und enthält auch einen Link zum API Explorer, damit Sie Ihre Abfrage mit Ihren 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 Builder sorgt dafür, dass die ausgewählten Felder, Segmente und Messwerte kompatibel sind und zusammen 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, den Query Builder aufzurufen: über eine bestimmte Seite in der Referenzdokumentation für die Berichterstellung oder über die Übersichtsseite des Query Builders.

Aus den Referenzdokumenten für die Berichterstellung

  1. Beginnen Sie mit den Referenzdokumenten für die Berichterstellung 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 wechseln.
  2. Klicken Sie auf Hilfe beim Erstellen einer Abfrage, um den Query Builder für diese Ressource aufzurufen.

Über die Übersichtsseite des Query Builders

Rufen Sie in der Referenzdokumentation für die 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 der Abfragevalidierung validieren.

API Explorer

Nachdem Sie die Abfrage erstellt haben, klicken Sie auf Im API Explorer ausprobieren, um die Abfrage im API Explorer zu öffnen. Ihre Abfrage wird automatisch in den Anfragetext eingefügt. Sie können sie dann testen, indem Sie sie für Ihre Kontodaten ausführen. Weitere Informationen zu diesem Tool finden Sie unter APIs 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.