Zeiträume

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

• Benutzerdefinierter Zeitraum
• Vordefinierter Zeitraum
• Vordefinierter Zeitraum
• Grenzwerte für den bisherigen Zeitraum

Benutzerdefinierter Zeitraum

Sie können Datumsangaben im erweiterten ISO 8601-Format (YYYY-MM-DD) oder im Basisformat (YYYYMMDD) angeben. Das erweiterte Format (YYYY-MM-DD) wird empfohlen, da es die Lesbarkeit verbessert. 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 den Zeitraum. 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:

Beispiel:

segments.date DURING LAST_30_DAYS

Vordefinierter Zeitraum

Einige Datumsfelder beziehen sich auf einen vordefinierten Zeitraum, nämlich:

• 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 (z. B. YYYY-MM-01, '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'

Grenzwerte für den historischen Rückblick

Die Verfügbarkeit von bisherigen Berichtsdaten 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 segmentiert werden (oder nach einem untermonatlichen Zeitraum gefiltert werden) und Daten für Zeiträume abrufen, die älter als 37 Monate sind, schlagen mit DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED in Version 24 und höher (oder DateRangeError.UNKNOWN in Version 23) fehl.
• Monatliche, vierteljährliche, jährliche oder nicht segmentierte Granularität (segments.month, segments.quarter, segments.year oder kein Datumssegment): Bis zu 11 Jahre an Verlaufsdaten werden unterstützt. Wenn Sie historische Daten abfragen möchten, die über den 37-Monats-Zeitraum hinausgehen, segmentieren Sie nach segments.month, segments.quarter oder segments.year oder lassen Sie Datumssegmente in SELECT weg. Achten Sie außerdem darauf, dass der WHERE-Zeitraum am ersten Tag eines Monats beginnt und am letzten Tag eines Monats endet (oder nach segments.month, segments.quarter oder segments.year gefiltert wird).