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"