Ergebnisse sortieren und einschränken

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

Ergebnisse sortieren

Mit der Klausel ORDER BY können Sie die Reihenfolge der Zeilen in Ihrer Antwort festlegen. Sie besteht aus einer oder mehreren kommagetrennten Sequenzen aus:

FieldName (ASC | DESC)?

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

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

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

Anzahl der Ergebnisse begrenzen

Mit der Klausel LIMIT und einer positiven Ganzzahl (1 oder höher; LIMIT 0 ist ungültig) können Sie die Gesamtzahl der zurückgegebenen Ergebnisse begrenzen. Wenn Sie diese Klausel mit der Sortierung der Ergebnisse kombinieren, können Sie Berichte mit den „Top N“-Ergebnissen erstellen, z. B. einen Bericht mit den fünf Kampagnen mit den höchsten 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, beachten Sie die folgenden Einschränkungen für die Filterung:

  • Die Filterung ist für Segmente nicht zulässig, ohne sie auszuwählen. Eine Ausnahme bilden die Felder für das Datumssegment (segments.date, segments.week, segments.month, segments.quarter und segments.year).
  • Die Filterung ist für zusammengesetzte MESSAGE-Felder nicht direkt zulässig (außer für einfache Wrapper-Nachrichten wie Int64Value und StringValue). Filtern Sie stattdessen nach den einfachen skalaren Unterfeldern (int64, string, bool) oder Enum-Unterfeldern.
  • Die Filterung ist für zusammengesetzte MESSAGE-Attribute wiederkehrender Felder nicht zulässig. Es können nur einfache skalare Unterfelder (int64, string, bool), Enum-Unterfelder oder einfache Wrapper-Unterfelder gefiltert werden.
Zurück
Berücksichtigung der Groß-/Kleinschreibung