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

Sie können die Reihenfolge der Zeilen in Ihrer Antwort mit der ORDER BY-Klausel angeben, die aus einer oder mehreren kommagetrennten Sequenzen besteht:

FieldName (ASC | DESC)?

Wenn Sie nach einem Feldnamen weder ASC noch DESC 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

Hinweis: In den folgenden Fällen ist eine Bestellung nicht möglich:

• 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

Sie können die Gesamtzahl der zurückgegebenen Ergebnisse mit der LIMIT-Klausel und einer positiven Ganzzahl (1 oder größer; LIMIT 0 ist nicht gültig) begrenzen. In Kombination mit der Sortierung der Ergebnisse können Sie Berichte mit den „Top-N“ 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

Beachten Sie beim Kombinieren von WHERE-Filtern mit ORDER BY und LIMIT die folgenden Filtereinschränkungen:

• Das Filtern nach Segmenten ist nur zulässig, wenn sie ausgewählt sind. Eine Ausnahme bilden die „wichtigsten“ Datumssegmentfelder (segments.date, segments.week, segments.month, segments.quarter und segments.year).
• Das Filtern ist nicht direkt für zusammengesetzte MESSAGE-Felder zulässig (mit Ausnahme von primitiven Wrapper-Nachrichten wie Int64Value und StringValue). Filtern Sie stattdessen nach ihren primitiven skalaren (int64, string, bool) oder Enum-Unterfeldern.
• Das Filtern nach zusammengesetzten MESSAGE-Attributen von wiederkehrenden Feldern ist nicht zulässig. Es kann nur nach primitiven skalaren (int64, string, bool), Enum- oder primitiven Wrapper-Unterfeldern gefiltert werden.