Berichte in der Google Ads-Benutzeroberfläche

In diesem Leitfaden werden die Konzepte und Benennungskonventionen für Berichte in der Google Ads-Benutzeroberfläche den Berichten zugeordnet, die Sie mit der Google Ads Query Language (GAQL) und der Google Ads API generieren können.

Häufig verwendete Begriffe in der Benutzeroberfläche

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

Benutzeroberfläche	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 das Ergebnis der Abfrage in mehrere Seiten aufgeteilt.

Spalten

Spalten in der Benutzeroberfläche entsprechen Ressourcenfeldern, Segmentfeldern und Messwerten in GAQL.

Filtern

Sie können die Daten in Ihren Berichten filtern und organisieren.

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 Möglichkeit in GAQL, 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.

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. Dazu verwenden Sie die Steuerelemente unten in jeder Datentabelle, mit denen Sie zwischen den Seiten wechseln und die Anzahl der anzuzeigenden Ergebnisse aus einer Reihe definierter Größen auswählen können.

Die Paginierung von Ergebnissen ist verfügbar, wenn Sie Berichte mit GoogleAdsService.Search über next_page_token abrufen. Wenn Sie alle Ergebnisse ohne Paginierung abrufen möchten, verwenden Sie GoogleAdsService.SearchStream.

Ergebnisse sortieren

In der Benutzeroberfläche können Sie 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 heruntergeladen werden, z. B. als CSV-, TSV- oder XML-Datei.

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

Berichte planen und per E-Mail senden

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

Vordefinierte Berichte

Sie können in der Google Ads-Benutzeroberfläche eine Liste vordefinierter Berichte erstellen.

Hier ist eine Liste der grundlegenden vordefinierten Berichte und der entsprechenden GAQL-Ressourcennamen.

Grundlegende vordefinierte Berichte	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	paid_organic_search_term_view
Landing page	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

Als Beispiel aus der vorherigen Tabelle können Sie mit der folgenden GAQL den Bericht „Konto“ generieren:

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 besteht einer der häufigsten Unterschiede darin, dass in der Benutzeroberfläche entfernte Entitäten implizit herausgefiltert werden, in der API jedoch nicht.

Wenn Sie eine Standardansicht der Benutzeroberfläche nachbilden möchten, müssen Sie einen Filter hinzufügen, in der Regel mit einem status-Feld, um entfernte Zeilen auszuschließen. Beispiel:

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