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.

Gängige Begriffe für die Benutzeroberfläche

In der folgenden Tabelle sind einige der gängigen Begriffe in der Benutzeroberfläche und ihre Zuordnung zur Google Ads-Abfragesprache (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	Sie können Segmentierung anwenden, indem Sie Segmentfelder in Ihre GAQL-Abfrage aufnehmen.
Seitenumbruch	Bei der Paginierung wird die Ergebnismenge der Abfrage in mehrere Seiten unterteilt.

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

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

In GAQL können Sie dies mit einem Filter nach segments.date in der WHERE-Klausel einer GAQL-Abfrage erreichen.

Filter

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

Segmentierung

Wenn Sie detailliertere Statistiken benötigen, können Sie die Daten nach Segmenten aufteilen. Angenommen, Sie möchten die Anzahl der Impressionen, die im Google Suchnetzwerk erzielt wurden, getrennt von den Impressionen im Google Displaynetzwerk sehen. Segmentieren Sie den Bericht in diesem Fall nach Netzwerk. Weitere Informationen zum Einbeziehen von Segmentfeldern in die SELECT-Klausel finden Sie unter Segmentierung.

Seitenumbruch

Mit den Steuerelementen am unteren Rand jeder Datentabelle können Sie in der Benutzeroberfläche zwischen den Berichtsseiten wechseln und die Anzahl der angezeigten Ergebnisse aus einer definierten Anzahl von Größen auswählen.

Das Blättern durch die Ergebnisse ist beim Abrufen von Berichten mit GoogleAdsService.Search bis next_page_token möglich. 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-Klausel und die LIMIT-Klausel verwenden, um die Abfrageergebnisse zu sortieren.

Downloadformate

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

Die API unterstützt verschiedene Formate in der Ausgabe nicht direkt. Daher müssen Sie 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.

Vordefinierte Berichte

Sie können in der Google Ads-Benutzeroberfläche eine Liste mit vordefinierten Berichten erstellen.

Hier finden Sie eine Liste der grundlegenden vordefinierten Berichte und die zugehörigen GAQL-Ressourcennamen.

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
Landingpage	landing_page_view
Maximierte Landingpage	expanded_landing_page_view

Anhand der Beispieltabelle oben können Sie mit der folgenden GAQL-Abfrage den Kontobericht 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

Wenn Sie Berichte in der Benutzeroberfläche mit API-Berichten vergleichen, ist einer der häufigsten Unterschiede, dass in der Benutzeroberfläche entfernte Entitäten implizit herausgefiltert werden, während dies bei der API nicht der Fall ist.

Wenn Sie eine Standard-UI-Ansicht replizieren 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"