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 diesem Leitfaden werden gängige Berichtskonzepte und Namenskonventionen 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 Aufforderungen in der Benutzeroberfläche folgen, um den Bericht zu erstellen, der Ihren Anforderungen am besten entspricht.

Tools und Ressourcen

Weitere Beispiele und automatisierte Hilfe beim Zuordnen von UI-Bildschirmen zur API finden Sie in den folgenden Ressourcen:

• Query Cookbook: Eine Sammlung von GAQL-Abfragen, mit denen die Daten auf vielen gängigen Google Ads-Benutzeroberflächen repliziert werden.
• 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 UI-Begriffe

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

UI-	GAQL
Spalten	Jede Ressource, jedes Segmentfeld oder jeder Messwert in der SELECT-Klausel einer GAQL-Abfrage.
Zeitraum	Zeiträume werden der WHERE-Klausel zugeordnet, die nach segments.date filtert.
Filter	Eine oder mehrere Bedingungen in der WHERE-Klausel.
Segmentfelder	Sie können Segmentierung anwenden, indem Sie Segmentfelder in Ihre GAQL-Abfrage einfügen.
Seitenumbruch	Bei der Paginierung wird die Ergebnismenge der Abfrage in mehrere Seiten aufgeteilt.

Spalten

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

Weitere Informationen zu den Spalten in der Statistiktabelle

Zeiträume

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

In GAQL haben Sie dieselbe Möglichkeit, indem Sie in der WHERE-Klausel einer GAQL-Abfrage nach segments.date filtern.

Filter

Filter in 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 im Google Suchnetzwerk separat vom Google Displaynetzwerk sehen. In diesem Fall sollten Sie Ihren Bericht nach Netzwerk segmentieren. Informationen dazu, wie Sie Segmentfelder in die SELECT-Anweisung einfügen, finden Sie unter Segmentierung.

Seitenumbruch

Mit den Steuerelementen unten in jeder Datentabelle können Sie in der Benutzeroberfläche durch Ihre Berichte navigieren. Damit lassen sich Seiten wechseln und die Anzahl der Ergebnisse auswählen, die aus einer definierten Menge von Größen angezeigt werden sollen.

Wenn Sie beim Abrufen von Berichten in den Ergebnissen blättern möchten, verwenden Sie GoogleAdsService.Search mit next_page_token. Wenn Sie die gesamte Ergebnismenge ohne Paginierung abrufen möchten, verwenden Sie GoogleAdsService.SearchStream.

Ergebnisse sortieren

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

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

Download-Formate

In der Benutzeroberfläche können Berichte in verschiedenen Formaten wie CSV, TSV oder XML heruntergeladen werden.

Die API formatiert die Ausgabe nicht direkt in Dateien wie CSV. Ihre Clientanwendung muss die Antwort also formatieren. Im Beispiel für Kampagnenbericht zu CSV-Code erfahren Sie, wie Sie die CSV-Formatierung in einem Client implementieren.

Berichte planen und per E-Mail senden

Sie können Berichte über die Benutzeroberfläche planen und per E‑Mail versenden, diese Funktionen werden jedoch nicht in der API unterstützt.

UI-Ansichten API-Ressourcen zuordnen

Hier finden Sie eine Liste mit häufig verwendeten UI-Ansichten und dem entsprechenden GAQL-Ressourcennamen.

UI-Ansichten	GAQL-Ressourcenname (in der FROM-Klausel angeben)
Konto	Kunde
Kampagne, Kampagnendetails	Kampagne
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 Wettbewerbsposition)^*	paid_organic_search_term_view
Landingpage	landing_page_view
Maximierte 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

^* Damit der Bericht Bezahlte und organische Suche generiert werden kann, 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 zusammengefassten Kontobericht für die letzten 7 Tage zu erstellen. Fügen Sie der SELECT-Klausel segments.date hinzu, wenn Sie Messwerte nach Tag aufgeschlüsselt haben 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 in der Benutzeroberfläche mit API-Berichten ist einer der häufigsten Unterschiede, dass in der Benutzeroberfläche entfernte Einheiten implizit herausgefiltert werden, in der API jedoch nicht.

Wenn Sie eine Standard-UI-Ansicht replizieren möchten, fügen Sie einen Filter mit einem status-Feld hinzu, um entfernte Zeilen auszuschließen oder ENABLED- und PAUSED-Entitäten explizit einzuschließen. Beispiel:

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