In diesem Leitfaden werden Konzepte und Namenskonventionen für Berichte auf der Google Ads-Benutzeroberfläche den Berichten zugeordnet, die Sie mit der Google Ads Query Language (GAQL) und der Google Ads API erstellen können.
Gängige 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) zusammengefasst.
UI | GAQL (LQL) |
---|---|
Spalten | Eine Ressource, ein Segmentfeld oder ein Messwert in der SELECT-Klausel einer GAQL-Abfrage. |
Zeitraum | Zeiträume entsprechen einer WHERE-Klausel, die nach segments.date filtert. |
Filter | Eine oder mehrere Bedingungen in der WHERE-Klausel. |
Segmentfelder | Wenden Sie die Segmentierung an, indem Sie Segmentfelder in die GAQL-Abfrage einschließen. |
Seitenumbruch | Beim Paging wird der Ergebnissatz der Abfrage auf mehrere Seiten aufgeteilt. |
Spalte
Spalten in der Benutzeroberfläche entsprechen Ressourcenfeldern, Segmentfeldern und Messwerten in GAQL.
Wird gefiltert
Zeiträume
In der Google Ads-Benutzeroberfläche werden Kontostatistiken in einer Tabelle angezeigt. Der Zeitraum für diese Statistik kann über ein Drop-down-Menü gesteuert werden.
In GAQL haben Sie dieselbe Kontrolle. Filtern Sie dazu in der WHERE-Klausel einer GAQL-Abfrage nach segments.date
.
Filter
Filter in der Benutzeroberfläche entsprechen einer oder mehreren Bedingungen in der WHERE-Klausel von GAQL.
Segmentierung
Sie erhalten detailliertere Statistiken, wenn Sie die Daten nach Segmenten unterteilen. Vielleicht möchten Sie z. B. die Anzahl der Impressionen speziell für das Google Suchnetzwerk und für das Google Displaynetzwerk ermitteln. In diesem Fall würden Sie den Bericht nach Werbenetzwerk segmentieren. Weitere Informationen zum Einschließen von Segmentfeldern in die SELECT-Klausel finden Sie unter Segmentierung.
Seitenumbruch
Sie können in der Benutzeroberfläche mit den Steuerelementen unten in den Datentabellen durch Ihre Berichte navigieren. Damit können Sie zu einer anderen Seite wechseln und die Anzahl der Ergebnisse auswählen, die aus einer Reihe von Größen angezeigt werden sollen.
Das Durchblättern von Ergebnissen ist beim Abrufen von Berichten mit GoogleAdsService.Search
bis next_page_token
möglich. Wenn Sie den gesamten Ergebnissatz ohne Paginierung abrufen möchten, verwenden Sie GoogleAdsService.SearchStream
.
Bestellergebnisse
In der Benutzeroberfläche können Sie die Ergebnisse durch Auswählen einer Spalte sortieren.
In GAQL können Sie die ORDER BY-Klausel und die LIMIT-Klausel verwenden, um das Abfrageergebnis zu ordnen.
Downloadformate
In der Benutzeroberfläche können Berichte in verschiedenen Formaten heruntergeladen werden, z. B. als CSV, TSV oder XML.
Die API unterstützt in der Ausgabe keine unterschiedlichen Formate, sodass Sie eine Nachbearbeitung vornehmen müssen. Codebeispiel zum Implementieren der CSV-Formatierung in einem Client
Berichte planen und per E-Mail senden
Das Planen und Senden von Berichten per E-Mail ist in der Benutzeroberfläche möglich, wird in der API jedoch nicht unterstützt.
Vordefinierte Berichte
Auf der Google Ads-Benutzeroberfläche können Sie eine Liste vordefinierter Berichte erstellen.
Im Folgenden finden Sie eine Liste der vordefinierten Berichte mit den 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 |
Landingpage | landing_page_view |
Maximierte Landingpage | expanded_landing_page_view |
Als Beispiel aus der obigen Tabelle können Sie die folgende GAQL-Datei 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 UI- und API-Berichten besteht einer der häufigsten Unterschiede darin, dass die Benutzeroberfläche entfernte Entitäten implizit herausfiltert, im Gegensatz zur API.
Zum Replizieren einer UI-Standardansicht müssen Sie einen Filter hinzufügen. Sie verwenden in der Regel ein status
-Feld, um entfernte Zeilen auszuschließen. Beispiel:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"