Ergebnisse sortieren und einschränken

Mit der Google Ads Query Language können Sie die in Ihren Abfrageantworten zurückgegebenen Zeilen mit den Klauseln ORDER BY und LIMIT sortieren und begrenzen.

Ergebnisse sortieren

Mit der ORDER BY-Klausel können Sie die Reihenfolge der Zeilen in Ihrer Antwort angeben. Sie besteht aus einer oder mehreren durch Kommas getrennten Sequenzen aus:

FieldName (ASC | DESC)?

Wenn Sie nach einem Feldnamen ASC oder DESC nicht angeben, wird in der Google Ads API standardmäßig ASC verwendet. Wenn Sie die ORDER BY-Klausel vollständig weglassen, ist die Reihenfolge der zurückgegebenen Zeilen nicht deterministisch.

Mit der folgenden ORDER BY-Klausel wird ein Bericht auf Kampagnenebene nach absteigenden Impressionen und aufsteigendem Kampagnennamen sortiert:

ORDER BY metrics.impressions DESC, campaign.name ASC
  • Über Attribute nicht ausgewählter Ressourcen
  • Nach nicht ausgewählten Messwerten
  • Durch nicht ausgewählte Segmente
  • Für Felder der folgenden Typen:
    • MESSAGE
    • Wiederkehrende Felder
    • Attribute wiederkehrender Felder

Anzahl der Ergebnisse begrenzen

Sie können die Gesamtzahl der zurückgegebenen Ergebnisse mit der LIMIT-Klausel und einer positiven Ganzzahl (1 oder höher; LIMIT 0 ist ungültig) begrenzen. In Kombination mit der Sortierung der Ergebnisse können Sie Berichte mit den „N Top-Ergebnissen“ erstellen, z. B. einen Bericht mit den fünf Kampagnen mit den meisten Impressionen in den letzten 30 Tagen:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

Ergebnisse filtern

Wenn Sie WHERE-Filter mit ORDER BY und LIMIT kombinieren, gelten die folgenden Filterbeschränkungen:

  • Das Filtern von Segmenten ist nur zulässig, wenn sie ausgewählt sind. Ausnahmen sind die „Core“-Datumssegmentfelder (segments.date, segments.week, segments.month, segments.quarter und segments.year).
  • Das Filtern von zusammengesetzten MESSAGE-Feldern ist nicht direkt zulässig (mit Ausnahme von Wrapper-Nachrichten für primitive Typen wie Int64Value und StringValue). Filtern Sie stattdessen nach den zugehörigen skalaren Unterfeldern (int64, string, bool) oder Enum-Unterfeldern.
  • Das Filtern ist für zusammengesetzte MESSAGE-Attribute von wiederholten Feldern nicht zulässig. Es können nur primitive skalare (int64, string, bool), Enum- oder primitive Wrapper-Unterfelder gefiltert werden.