Berichte in der Google Ads-Benutzeroberfläche

Die Google Ads-Benutzeroberfläche bietet Berichtsfunktionen. Wenn Sie einen Bericht erstellen möchten, melden Sie sich in Ihrem Google Ads-Konto an, klicken Sie im linken Navigationsmenü auf Kampagnen und dann auf Statistiken und Berichte. Wenn Sie einen Bericht von Grund auf neu erstellen möchten, klicken Sie auf Berichtseditor.

In dieser Anleitung werden gängige Berichtskonzepte und Benennungskonventionen in der Google Ads-Benutzeroberfläche Berichten zugeordnet, die Sie mit der Google Ads Query Language (GAQL) und der Google Ads API erstellen können. Sie können auch den Anweisungen auf der Benutzeroberfläche folgen, um den Bericht zu erstellen, der Ihren Anforderungen am besten entspricht.

Tools und Ressourcen

Weitere Beispiele und automatisierte Hilfe bei der Zuordnung von Benutzeroberflächen zu APIs finden Sie in den folgenden Ressourcen:

• Query Cookbook: Eine Sammlung von GAQL-Abfragen, die die Daten auf vielen gängigen Google Ads-Benutzeroberflächen nachbilden.
• Google Ads API Reporting Extension: Eine Chrome-Erweiterung mit der Sie API-Ressourcen- und Feldnamen direkt in der Google Ads-Benutzeroberfläche ermitteln können.

Häufig verwendete Begriffe auf der Benutzeroberfläche

In der folgenden Tabelle sind einige der häufig verwendeten Begriffe auf der Benutzeroberfläche und ihre Zuordnungen zur Google Ads Query Language (GAQL) zusammengefasst.

UI	GAQL
Spalten	Eine beliebige Ressource, ein beliebiges Segmentfeld oder ein beliebiger Messwert in der SELECT Klausel einer GAQL-Abfrage.
Zeitraum	Zeiträume werden einer WHERE Klausel zugeordnet, die nach segments.date filtert.
Filter	Eine oder mehrere Bedingungen in der WHERE Klausel.
Segmentfelder	Wenden Sie die Segmentierung an, indem Sie Segmentfelder in Ihre GAQL-Abfrage einbeziehen.
Seitenumbruch	Durch die Paginierung wird die Ergebnismenge der Abfrage in mehrere Seiten aufgeteilt.

Spalten

Spalten auf der Benutzeroberfläche entsprechen der Verwendung einer SELECT Klausel für Ressourcenfelder, Segmentfelder oder Messwerte in GAQL.

Weitere Informationen finden Sie unter Spalten in der Statistik tabelle.

Zeiträume

Die Google Ads-Benutzeroberfläche enthält eine Tabelle mit Kontostatistiken und ein Drop-down-Menü, mit dem Sie den Zeitraum für diese Statistiken festlegen können.

Sie haben dieselbe Kontrolle in GAQL, indem Sie in der WHERE Klausel einer GAQL Abfrage nach segments.date filtern.

Filter

Filter auf der Benutzeroberfläche entsprechen einer oder mehreren Bedingungen in der WHERE Klausel von GAQL.

Weitere Informationen finden Sie unter Ansicht der Leistungsdaten filtern.

Segmentierung

Für detailliertere Statistiken können Sie die Daten nach Segmenten aufteilen. Angenommen, Sie möchten die Anzahl der Impressionen für das Google Suchnetzwerk getrennt vom Google Displaynetzwerk sehen. In diesem Fall segmentieren Sie Ihren Bericht nach Netzwerk. Unter Segmentierung erfahren Sie, wie Sie Segmentfelder in die SELECT Klausel einbeziehen.

Seitenumbruch

Sie können in der Benutzeroberfläche in Ihren Berichten navigieren. Verwenden Sie dazu die Steuerelemente unten in jeder Datentabelle, mit denen Sie zwischen den Seiten wechseln und die Anzahl der anzuzeigenden Ergebnisse aus einer definierten Anzahl von Größen auswählen können.

Wenn Sie Berichte abrufen, verwenden Sie GoogleAdsService.Search mit next_page_token, um durch die Ergebnisse zu blättern. Verwenden Sie GoogleAdsService.SearchStream, um die gesamte Ergebnismenge ohne Paginierung abzurufen.

Ergebnisse sortieren

Auf der Benutzeroberfläche können Sie die Ergebnisse sortieren, indem Sie eine Spalte auswählen.

In GAQL können Sie die ORDER BY Klausel und LIMIT Klausel verwenden, um Ihre Abfrageergebnisse zu sortieren und zu begrenzen.

Downloadformate

Auf der Benutzeroberfläche können Berichte in verschiedenen Formaten heruntergeladen werden, z. B. als CSV-, TSV- oder XML-Datei.

Die API formatiert die Ausgabe nicht direkt in Dateien wie CSV. Daher muss Ihre Clientanwendung die Antwort formatieren. Im Codebeispiel Kampagnenbericht in CSV-Datei exportieren erfahren Sie, wie Sie die CSV-Formatierung in einem Client implementieren.

Berichte planen und per E-Mail senden

Sie können einen Bericht auf der Benutzeroberfläche planen und per E-Mail senden. Diese Funktionen werden in der API jedoch nicht unterstützt.

Benutzeroberflächenansichten API-Ressourcen zuordnen

Hier finden Sie eine Liste der häufig verwendeten Benutzeroberflächenansichten und der entsprechenden GAQL-Ressourcennamen.

Benutzeroberflächenansichten	GAQL-Ressourcenname (in der FROM-Klausel angeben)
Konto	customer
Kampagne, Kampagnendetails	campaign
Anzeigengruppe, Anzeigengruppendetails	ad_group
Anzeige, Finale URL	ad_group_ad
Keyword für Suchanzeigen	keyword_view
Suchbegriffe	search_term_view
Bezahlt und organisch (Vorlage für Wettbewerbsübersicht)^*	paid_organic_search_term_view
Landing page	landing_page_view
Erweiterte Landingpage	expanded_landing_page_view
Inhalte > Placements	managed_placement_view
Inhalte > Wo Anzeigen ausgeliefert wurden	group_placement_view
Inhalte > Wo Anzeigen ausgeliefert wurden > Details ansehen	detail_placement_view
Zielgruppen > Demografische Merkmale > Alter	age_range_view
Zielgruppen > Demografische Merkmale > Geschlecht	gender_view
Standorte	location_view
Inhalte > Themen	topic_view
Standorte > Bericht nach Standort	geographic_view

^* Wenn Sie den Bericht Bezahlt und organisch erstellen möchten, müssen Sie ein Google Search Console-Konto auf Kundenebene mit Ihrem Google Ads-Konto verknüpfen.

Als Beispiel aus der vorherigen Tabelle können Sie die folgende GAQL-Abfrage verwenden, um einen aggregierten Kontobericht für die letzten 7 Tage zu erstellen. Fügen Sie segments.date der SELECT-Klausel hinzu, wenn Sie Messwerte nach Tag aufgeschlüsselt sehen möchten:

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

Häufige Unterschiede

Beim Vergleich von Berichten auf der Benutzeroberfläche mit API-Berichten besteht einer der häufigsten Unterschiede darin, dass auf der Benutzeroberfläche entfernte Entitäten implizit herausgefiltert werden, in der API jedoch nicht.

Wenn Sie eine Standardansicht der Benutzeroberfläche nachbilden möchten, fügen Sie einen Filter mit einem status-Feld hinzu, um entfernte Zeilen auszuschließen oder ENABLED- und PAUSED-Entitäten explizit einzubeziehen. Beispiel:

SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'