Zeiträume

Mit der Google Ads Query Language können Sie den Zeitraum auf folgende Weise angeben:

Benutzerdefinierter Zeitraum

Sie können Datumsangaben im erweiterten ISO 8601 (YYYY-MM-DD) oder im Basisformat (YYYYMMDD) angeben. Aus Gründen der Lesbarkeit wird das erweiterte Format (YYYY-MM-DD) empfohlen. Verwenden Sie BETWEEN oder Vergleichs operatoren (=, >, >=, <, <=) 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 Literalen für vordefinierte 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 sieht so aus:

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-Tage-Arbeitswoche (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-Tage-Zeitraum ab dem vorherigen Sonntag
LAST_WEEK_MON_SUN der 7-Tage-Zeitraum ab dem vorherigen Montag

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 Rückblick auf Verlaufsdaten

Die Verfügbarkeit von Berichtsdaten für Verlaufsberichte hängt vom Detaillierungsgrad 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 mehr als 37 Monate zurückliegt, schlagen in Version 24 und höher mit DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED fehl (oder in Version 23 mit DateRangeError.UNKNOWN).
  • Monatliche, vierteljährliche, jährliche oder nicht segmentierte Granularität (segments.month, segments.quarter, segments.year oder kein Datumssegment) : Unterstützt bis zu 11 Jahre Verlaufsdaten. Wenn Sie Verlaufsdaten abfragen möchten, die mehr als 37 Monate zurückliegen, segmentieren Sie nach segments.month, segments.quarter oder segments.year oder lassen Sie Datumssegmente in SELECT weg. Der Zeitraum in WHERE muss am ersten Tag eines Monats beginnen und am letzten Tag eines Monats enden. Alternativ können Sie nach segments.month, segments.quarter oder segments.year filtern.