Berichte in der Benutzeroberfläche

In diesem Leitfaden werden Konzepte und Namenskonventionen für Berichte in der Google Ads-Benutzeroberfläche beschrieben. zu den Berichten hinzufügen, die Sie mit der Google Ads Query Language (GAQL) und Google Ads API.

Allgemeine Begriffe der Benutzeroberfläche

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

UI	GAQL
Spalten	Jede Ressource, jedes Segmentfeld oder jeder Messwert in der SELECT-Klausel einer GAQL-Abfrage.
Zeitraum	Zeiträume sind einem WHERE zugeordnet. Klausel zum Filtern nach segments.date.
Filter	Eine oder mehrere Bedingungen in der WHERE-Klausel.
Segmentfelder	Wenden Sie die Segmentierung an, indem Sie Segmentfelder einschließen. GAQL-Abfrage hinzugefügt.
Seitenumbruch	Durch Paging wird die Ergebnismenge in mehrere Seiten aufzuteilen.

Spalten

Spalten in der Benutzeroberfläche entsprechen Resource Felder, Segment Felder und Messwerte in GAQL

Filtern

Zeiträume

Auf der Google Ads-Benutzeroberfläche werden Kontostatistiken in einer Tabelle angezeigt. Über das Drop-down-Menü können Sie den Zeitraum für diese Statistiken zu steuern.

In GAQL haben Sie die gleiche Kontrolle, indem Sie nach segments.date in der WHERE-Klausel einer GAQL Abfrage.

Filter

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

Segmentierung

Sie erhalten detailliertere Statistiken, wenn Sie die Daten nach Segmenten unterteilen. Beispiel: ist die Anzahl der Impressionen für den Google Suchnetzwerk getrennt vom Google Displaynetzwerk In diesem Fall würden Sie den Bericht nach Werbenetzwerk segmentieren. Weitere Informationen finden Sie unter Segmentierung nach Segmentierung in der SELECT-Klausel.

Seitenumbruch

Mit den Steuerelementen auf der Benutzeroberfläche navigieren Sie durch die Berichte. unten in jeder Datentabelle, über die Sie zwischen den Seiten wechseln und die Anzahl der für die Anzeige von Ergebnissen aus einem definierten Satz von Größen.

Das Blättern in den Ergebnissen ist verfügbar, wenn Berichte mit GoogleAdsService.Search bis next_page_token Um den gesamten Ergebnissatz abzurufen ohne Paginierung, verwenden Sie GoogleAdsService.SearchStream

Bestellergebnisse

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

In GAQL können Sie die Funktion ORDER BY Klausel und LIMIT Klausel um Ihr Abfrageergebnisse zu ordnen.

Downloadformate

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

Die API unterstützt verschiedene Formate in ihrer Ausgabe nicht direkt, daher würden Sie eine Nachbearbeitung vornehmen müssen. Eine Codebeispiel für die Implementierung der CSV-Formatierung in einer Kunde.

Berichte planen und per E-Mail senden

Das Planen und Senden von Berichten per E-Mail ist in der Benutzeroberfläche verfügbar, wird jedoch nicht unterstützt in die API verwenden.

Vordefinierte Berichte

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

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

Einfache vordefinierte Berichte	GAQL-Ressourcenname (in 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

Als Beispiel aus der obigen Tabelle können Sie die folgende GAQL verwenden, um Kontobericht:

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

Einer der häufigsten Unterschiede beim Vergleich von UI- und API-Berichten ist dass die Benutzeroberfläche entfernte Entitäten implizit filtert, die API jedoch nicht.

Um eine Standardansicht der Benutzeroberfläche zu replizieren, müssen Sie einen Filter hinzufügen. mithilfe des Felds status, um entfernte Zeilen auszuschließen. Beispiel:

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