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 erstellen können.
Häufig verwendete Begriffe für die Benutzeroberfläche
In der folgenden Tabelle sind einige der häufig verwendeten Begriffe in der Benutzeroberfläche und ihre Entsprechungen in der Google Ads Query Language (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 | Wenden Sie Segmentierung an, indem Sie Segmentfelder in Ihre GAQL-Abfrage einfügen. |
| 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
In der Google Ads-Benutzeroberfläche gibt es eine Tabelle mit Kontostatistiken und ein Drop-down-Menü, mit dem 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.
Segmentierung
Für detailliertere Statistiken können Sie die Daten nach Segmenten aufteilen. Angenommen, Sie möchten die Anzahl der Impressionen im Google Suchnetzwerk separat vom Google Displaynetzwerk sehen. In diesem Fall sollten Sie Ihren Bericht nach Netzwerk segmentieren. Informationen dazu, wie Sie Segmentfelder in die SELECT-Klausel einfügen, finden Sie unter Segmentierung.
Seitenumbruch
Mit den Steuerelementen unten in jeder Datentabelle können Sie in der Benutzeroberfläche durch Ihre Berichte navigieren. Damit lassen sich Seiten wechseln und die Anzahl der Ergebnisse auswählen, die in einer bestimmten Größe angezeigt werden sollen.
Das Paging durch Ergebnisse ist beim Abrufen von Berichten mit GoogleAdsService.Search über next_page_token verfügbar. Wenn Sie das gesamte Ergebnis-Set 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 das Ergebnis Ihrer Abfrage zu sortieren.
Download-Formate
In der Benutzeroberfläche können Berichte in verschiedenen Formaten wie CSV, TSV oder XML heruntergeladen werden.
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 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 eine Liste vordefinierter Berichte in der Google Ads-Benutzeroberfläche erstellen.
Hier finden Sie eine Liste der grundlegenden vordefinierten Berichte und der entsprechenden GAQL-Ressourcennamen.
| Einfache 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 |
| Erweiterte Landingpage | expanded_landing_page_view |
Als Beispiel aus der vorherigen Tabelle können Sie die folgende GAQL 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 Berichten in der Benutzeroberfläche mit API-Berichten ist einer der häufigsten Unterschiede, dass in der Benutzeroberfläche entfernte Einheiten implizit herausgefiltert werden, in der API jedoch nicht.
Wenn Sie eine Standard-UI-Ansicht replizieren möchten, müssen Sie einen Filter hinzufügen, in der Regel mit dem Feld status, um entfernte Zeilen auszuschließen. Beispiel:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"