Zeiträume

In der Google Ads Query Language können Sie den Zeitraum so angeben:

Benutzerdefinierter Zeitraum

Sie können Datumsangaben im erweiterten (YYYY-MM-DD) oder einfachen (YYYYMMDD) ISO 8601-Format angeben. Das erweiterte Format (YYYY-MM-DD) wird zur besseren Lesbarkeit empfohlen. Verwenden Sie BETWEEN oder Vergleichsoperatoren (=, >, >=, <, <=) mit benutzerdefinierten Datumsstrings:

segments.date BETWEEN '2026-01-01' AND '2026-01-31'

segments.date >= '20260701' AND segments.date <= '20260731'

Vordefinierter Zeitraum

Verwenden Sie den Operator DURING mit vordefinierten Literalen für Zeiträume. Der Operator DURING unterstützt nur vordefinierte Zeiträume und kann nicht mit benutzerdefinierten Datumsstrings verwendet werden.

Die Liste der gültigen vordefinierten Zeiträume lautet wie folgt:

Zeitraum Berichte werden generiert für…
TODAY nur heute
YESTERDAY nur gestern
LAST_7_DAYS die letzten sieben Tage ausschließlich heute
LAST_BUSINESS_WEEK Die 5-tägige Arbeitswoche von Montag bis Freitag der vorherigen Arbeitswoche.
THIS_MONTH alle Tage im aktuellen Monat
LAST_MONTH alle Tage im vorherigen Monat
LAST_14_DAYS die letzten 14 Tage ausschließlich heute
LAST_30_DAYS die letzten 30 Tage ausschließlich heute
THIS_WEEK_SUN_TODAY Der Zeitraum zwischen dem vorherigen Sonntag und dem aktuellen Tag.
THIS_WEEK_MON_TODAY Der Zeitraum zwischen dem vorherigen Montag und dem aktuellen Tag.
LAST_WEEK_SUN_SAT Der 7-tägige Zeitraum, der am vorherigen Sonntag beginnt.
LAST_WEEK_MON_SUN Der 7-tägige Zeitraum, der am vorherigen Montag beginnt.

Beispiel:

segments.date DURING LAST_30_DAYS

Vordefinierter Zeitraum

Einige Datumsfelder beziehen sich auf einen vordefinierten Zeitraum, insbesondere:

  • segments.week
  • segments.month
  • segments.quarter

Wenn Sie diese Segmente mit benutzerdefinierten Datumsstrings filtern (mit =, BETWEEN, >=, <=, > oder <), müssen Sie ein Datum angeben, das der erste Tag des Zeitraums ist:

  • segments.week: Montag der Woche (z. B. '2026-05-04').
  • segments.month: Erster Tag des Monats (YYYY-MM-01, z. B. '2026-05-01').
  • segments.quarter: Erster Tag des Kalenderquartals (YYYY-01-01, YYYY-04-01, YYYY-07-01 oder YYYY-10-01).

Wenn Sie ein Datum angeben, das nicht der erste Tag des Zeitraums ist, wird der Fehler QueryError.MISALIGNED_DATE_FOR_FILTER zurückgegeben. Sie können diese Segmente auch mit dem Operator DURING und einem vordefinierten Zeitraum filtern.

Wenn Sie beispielsweise den Monat Mai im Jahr 2026 angeben möchten, verwenden Sie die folgende Bedingung und geben Sie den ersten Tag dieses Monats an:

segments.month = '2026-05-01'

Limits für den Lookback-Verlauf

Die Verfügbarkeit von Berichtsdaten aus der Vergangenheit hängt von der Granularität der ausgewählten oder gefilterten Datumssegmente ab:

  • Tägliche, wöchentliche und stündliche Granularität (segments.date, segments.week und segments.hour): Unterstützt ein Lookback-Window von bis zu 37 Monaten. Abfragen, die nach segments.date, segments.week oder segments.hour segmentieren (oder nach einem Zeitraum filtern, der kürzer als ein Monat ist) und sich auf Daten außerhalb des 37-monatigen Zeitraums beziehen, schlagen in Version 24 und höher mit DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (oder in Version 23 mit DateRangeError.UNKNOWN) fehl.
  • Monatliche, vierteljährliche, jährliche oder unsegmentierte Detaillierung (segments.month, segments.quarter, segments.year oder kein Datumssegment): Unterstützt bis zu 11 Jahre an Verlaufsdaten. Wenn Sie Verlaufsdaten abfragen möchten, die älter als 37 Monate sind, segmentieren Sie nach segments.month, segments.quarter oder segments.year oder lassen Sie Datumssegmente in SELECT weg. Achten Sie darauf, dass der Zeitraum für WHERE am ersten Tag eines Monats beginnt und am letzten Tag eines Monats endet (oder filtern Sie nach segments.month, segments.quarter oder segments.year).
Zurück
Abfragestruktur
Weiter
Berücksichtigung der Groß-/Kleinschreibung