Berichte in der Google Ads-Benutzeroberfläche

In der Google Ads-Benutzeroberfläche stehen Berichtsfunktionen zur Verfügung. Wenn Sie einen Bericht erstellen möchten, melden Sie sich in Ihrem Google Ads-Konto an. Klicken Sie links 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 generieren 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 detaillierte 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 Begriffe für die Benutzeroberfläche

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 einer WHERE-Klausel zugeordnet, die nach segments.date filtert.
Filter	Eine oder mehrere Bedingungen in der WHERE-Klausel.
Segmentfelder	Wenden Sie Segmentierung an, 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 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

Wenn Sie detailliertere Statistiken sehen möchten, teilen Sie die Daten in Segmente auf. 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 einfügen.

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 in einer bestimmten Größe angezeigt werden sollen.

Das Paginieren von Ergebnissen ist beim Abrufen von Berichten mit GoogleAdsService.Search über next_page_token möglich. Wenn Sie das gesamte Ergebnis 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-Klausel und die LIMIT-Klausel verwenden, um das Ergebnis Ihrer Abfrage zu sortieren.

Download-Formate

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

Die API unterstützt in ihrer Ausgabe nicht direkt verschiedene Formate. Sie müssen also eine Nachbearbeitung durchführen. In diesem Codebeispiel wird gezeigt, wie die CSV-Formatierung in einem Client implementiert wird.

Berichte planen und per E-Mail senden

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

UI-Ansichten API-Ressourcen zuordnen

Hier finden Sie eine Liste der gängigen Benutzeroberflächenansichten und der 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
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

^* 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 den folgenden GAQL verwenden, um den Kontobericht zu erstellen:

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, müssen Sie einen Filter hinzufügen, in der Regel mit dem Feld status, um entfernte Zeilen auszuschließen. Beispiel:

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