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 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 Aufforderungen in der Benutzeroberfläche folgen, um den Bericht zu erstellen, der Ihren Anforderungen am besten entspricht.

Tools und Ressourcen

Ausführlichere 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 repliziert werden, die auf vielen gängigen Google Ads-UI-Bildschirmen zu finden sind.
• Google Ads API Reporting Extension: Eine Chrome-Erweiterung, mit der Sie API-Ressourcen- und Feldnamen direkt in der Google Ads-Benutzeroberfläche identifizieren können.

Gängige UI-Begriffe

In der folgenden Tabelle sind einige der gängigen Begriffe aus der Benutzeroberfläche und ihre Zuordnung zur Google Ads Query Language (GAQL) zusammengefasst.

UI-	GAQL
Spalten	Alle Ressourcen, Segmentfelder oder Messwerte 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 einfügen.
Seitenumbruch	Durch die Paginierung wird die Ergebnismenge der Abfrage auf 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 finden Sie unter Spalten in der Statistiktabelle.

Zeiträume

In der Google Ads-Benutzeroberfläche gibt es eine Tabelle mit Kontostatistiken und ein Drop-down-Menü, über das 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 von Leistungsdaten filtern.

Segmentierung

Wenn Sie detailliertere Statistiken benötigen, können Sie die Daten nach Segmenten aufteilen. Angenommen, Sie möchten die Anzahl der Impressionen im Google Suchnetzwerk getrennt vom Google Displaynetzwerk sehen. Segmentieren Sie den Bericht in diesem Fall nach Netzwerk. Unter Segmentierung erfahren Sie, wie Sie Segmentfelder in die SELECT-Klausel einfügen.

Seitenumbruch

Sie können in der Benutzeroberfläche mithilfe der Steuerelemente unten in jeder Datentabelle durch Ihre Berichte navigieren. Damit können Sie die Seiten wechseln und die Anzahl der anzuzeigenden Ergebnisse aus einer vordefinierten Liste von Größen auswählen.

Wenn Sie beim Abrufen von Berichten durch die Ergebnisse 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 nach einer Spalte sortieren.

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

Downloadformate

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

Die API formatiert die Ausgabe nicht direkt in Dateien wie CSV. Daher muss Ihre Clientanwendung die Antwort formatieren. Im Codebeispiel für den Kampagnenbericht im CSV-Format erfahren Sie, wie Sie die CSV-Formatierung in einem Client implementieren.

Berichte planen und per E-Mail senden

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

UI-Ansichten API-Ressourcen zuordnen

Hier finden Sie eine Liste gängiger UI-Ansichten 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 erstellt 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 aggregierten 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 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 aus der Benutzeroberfläche mit Berichten aus der API ist einer der häufigsten Unterschiede, dass in der Benutzeroberfläche entfernte Entitäten 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'