In diesem Leitfaden werden Konzepte und Namenskonventionen 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.
Allgemeine Begriffe der Benutzeroberfläche
In der folgenden Tabelle sind einige der auf der Benutzeroberfläche verwendeten allgemeinen Begriffe und ihre Zuordnung zur 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 sind einer WHERE-Klausel zugeordnet, mit der nach segments.date gefiltert wird. |
Filter | Eine oder mehrere Bedingungen in der WHERE-Klausel. |
Segmentfelder | Wenden Sie die Segmentierung an, indem Sie Segmentfelder in Ihre GAQL-Abfrage einbeziehen. |
Seitenumbruch | Bei der Paging wird die Ergebnismenge der Abfrage auf mehrere Seiten aufgeteilt. |
Spalte
Die Spalten in der UI entsprechen Ressourcenfeldern, Segmentfeldern und Messwerten in GAQL.
Wird gefiltert
Zeiträume
Auf 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 die gleiche Kontrolle, wenn Sie in der WHERE-Klausel einer GAQL-Abfrage nach segments.date
filtern.
Filter
Die 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. Sie können beispielsweise die Anzahl der Impressionen für das Google Suchnetzwerk getrennt vom Google Displaynetzwerk sehen. In diesem Fall segmentieren Sie den Bericht nach Netzwerk. Informationen zum Einschließen von Segmentfeldern in die SELECT-Klausel finden Sie unter Segmentierung.
Seitenumbruch
Mit den Steuerelementen unten in jeder Datentabelle können Sie in den Berichten auf der Benutzeroberfläche navigieren. Damit können Sie zwischen den Seiten wechseln und die Anzahl der Ergebnisse auswählen, die für einen definierten Satz von Größen angezeigt werden sollen.
Das Blättern in den Ergebnissen ist verfügbar, wenn Berichte mit GoogleAdsService.Search
bis next_page_token
abgerufen werden. Um den gesamten Ergebnissatz ohne Paginierung abzurufen, 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 ORDER BY-Klausel und die LIMIT-Klausel verwenden, um Ihr Abfrageergebnis zu ordnen.
Downloadformate
In der Benutzeroberfläche können Berichte in verschiedenen Formaten wie CSV, TSV oder XML heruntergeladen werden.
Die API unterstützt verschiedene Ausgabeformate nicht direkt, sodass Sie eine Nachbearbeitung vornehmen müssen. Codebeispiel für die Implementierung der CSV-Formatierung in einem Client
Berichte planen und per E-Mail senden
Berichte können in der Benutzeroberfläche geplant und per E-Mail gesendet werden. In der API wird sie 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 grundlegenden vordefinierten Berichte und der zugehörigen GAQL-Ressourcennamen.
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 den Kontobericht zu 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
Einer der häufigsten Unterschiede beim Vergleich von UI- und API-Berichten besteht darin, dass die Benutzeroberfläche entfernte Entitäten implizit filtert, die API jedoch nicht.
Wenn Sie eine Standard-UI-Ansicht replizieren möchten, müssen Sie einen Filter hinzufügen. Verwenden Sie dazu normalerweise das Feld status
, um entfernte Zeilen auszuschließen. Beispiel:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"