Die Google Ads-Benutzeroberfläche bietet Berichtsfunktionen. Melden Sie sich in Ihrem Google Ads-Konto an, um einen Bericht zu erstellen. Klicken Sie links auf Kampagnen und dann auf Statistiken und Berichte. Wenn Sie einen Bericht von Grund auf neu erstellen möchten, klicken Sie auf Berichtseditor.
In diesem Leitfaden werden häufig verwendete Berichtskonzepte und Namenskonventionen in der Google Ads-Benutzeroberfläche Berichten zugeordnet, die Sie mit der Google Ads Query Language (GAQL) und der Google Ads API erstellen können. Sie können auch den Anweisungen auf der Benutzeroberfläche folgen, um den Bericht zu erstellen, der Ihren Anforderungen am besten entspricht.
Tools und Ressourcen
Weitere detaillierte Beispiele und automatisierte Hilfe bei der Zuordnung von Benutzeroberflächen zu APIs finden Sie in den folgenden Ressourcen:
- Query Cookbook: Eine Sammlung von GAQL-Abfragen, die die Daten auf vielen häufig verwendeten Google Ads-Benutzeroberflächen nachbilden.
- Google Ads API Reporting Extension: Eine Chrome-Erweiterung, mit der Sie API-Ressourcen- und Feldnamen direkt in der Google Ads-Benutzeroberfläche identifizieren können.
Häufig verwendete Begriffe auf der Benutzeroberfläche
In der folgenden Tabelle sind einige der häufig verwendeten Begriffe auf der Benutzeroberfläche und ihre Zuordnungen zur Google Ads Query Language (GAQL) zusammengefasst.
| Benutzeroberfläche | GAQL |
|---|---|
| Spalten | Eine beliebige Ressourcen-, Segment- oder Messwertspalte 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 auf der Benutzeroberfläche entsprechen der Verwendung einer SELECT-Klausel für Ressourcenfelder, Segmentfelder oder Messwerte in GAQL.
Weitere Informationen finden Sie unter Spalten der Statistiktabellen.
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 die gleiche Kontrolle in GAQL, indem Sie in der WHERE-Klausel einer GAQL
Abfrage nach
segments.date filtern.
Filter
Filter auf der Benutzeroberfläche entsprechen einer oder mehreren Bedingungen in der WHERE-Klausel von GAQL.
Weitere Informationen finden Sie unter Ansicht der Leistungsdaten filtern.
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 durch Ihre Berichte navigieren. Verwenden Sie dazu die Steuerelemente unten in jeder Datentabelle, mit denen Sie zwischen den Seiten wechseln und die Anzahl der anzuzeigenden Ergebnisse aus einer definierten Anzahl von 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 das gesamte Ergebnis ohne Paginierung abrufen möchten, verwenden Sie
GoogleAdsService.SearchStream.
Ergebnisse sortieren
Auf der Benutzeroberfläche können Sie die Ergebnisse sortieren, indem Sie eine Spalte auswählen.
In GAQL können Sie die Anweisung ORDER BY und die Anweisung LIMIT verwenden, um das Ergebnis Ihrer Abfrage zu sortieren.
Download-Formate
Auf 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 auf der Benutzeroberfläche planen und per E-Mail senden. Diese Funktionen werden in der API jedoch nicht unterstützt.
Benutzeroberflächenansichten API-Ressourcen zuordnen
Hier finden Sie eine Liste häufig verwendeter Benutzeroberflächenansichten und der entsprechenden GAQL-Ressourcennamen.
| Benutzeroberflächenansichten | GAQL-Ressourcenname (in der FROM-Klausel angeben) |
|---|---|
| Konto | customer |
| Kampagne, Kampagnendetails |
campaign |
| Anzeigengruppe, Anzeigengruppendetails |
ad_group |
|
Anzeige, Finale URL |
ad_group_ad |
| Keyword für Suchanzeigen | keyword_view |
| Suchbegriffe | search_term_view |
| Bezahlt und organisch (Vorlage für Wettbewerbsübersicht)* |
paid_organic_search_term_view |
| Landing page | landing_page_view |
| Erweiterte 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 |
| Zielgruppen > Demografische Merkmale > Alter | age_range_view |
| Zielgruppen > Demografische Merkmale > Geschlecht | gender_view |
| Standorte | location_view |
| Inhalte > Themen | topic_view |
| Standorte > Bericht nach Standort | geographic_view |
* Wenn Sie den Bericht Bezahlt und organisch erstellen möchten, müssen Sie auf Kundenebene ein Google Search Console-Konto mit Ihrem Google Ads-Konto verknüpfen.
Als Beispiel aus der vorherigen Tabelle können Sie mit der folgenden GAQL den Bericht „Konto“ 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 auf der Benutzeroberfläche mit API-Berichten besteht einer der häufigsten Unterschiede darin, dass auf 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'