Zakresy dat

Język zapytań Google Ads umożliwia określanie zakresu dat na te sposoby:

Niestandardowy zakres dat

Daty możesz podawać w formacie rozszerzonym (YYYY-MM-DD) lub podstawowym (YYYYMMDD) ISO 8601. Zalecamy format rozszerzony (YYYY-MM-DD), ponieważ jest bardziej czytelny. Użyj operatora BETWEEN lub operatorów porównania (=, >, >=, <, <=) z niestandardowymi ciągami znaków daty:

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

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

Wstępnie zdefiniowany zakres dat

Używaj operatora DURING ze wstępnie zdefiniowanymi literałami zakresu dat. Operator DURING obsługuje tylko wstępnie zdefiniowane zakresy dat i nie można go używać z niestandardowymi ciągami dat.

Oto lista prawidłowych wstępnie zdefiniowanych zakresów dat:

Zakres dat Raporty są generowane dla…
TODAY Tylko dzisiaj.
YESTERDAY Tylko wczoraj.
LAST_7_DAYS Ostatnie 7 dni bez dnia dzisiejszego.
LAST_BUSINESS_WEEK 5-dniowy tydzień roboczy, od poniedziałku do piątku, poprzedniego tygodnia roboczego.
THIS_MONTH Wszystkie dni w bieżącym miesiącu.
LAST_MONTH Wszystkie dni w poprzednim miesiącu.
LAST_14_DAYS Ostatnie 14 dni (bez dnia dzisiejszego).
LAST_30_DAYS Ostatnie 30 dni bez dnia dzisiejszego.
THIS_WEEK_SUN_TODAY Okres między poprzednią niedzielą a bieżącym dniem.
THIS_WEEK_MON_TODAY Okres od poprzedniego poniedziałku do bieżącego dnia.
LAST_WEEK_SUN_SAT 7-dniowy okres rozpoczynający się w poprzednią niedzielę.
LAST_WEEK_MON_SUN 7-dniowy okres rozpoczynający się w poprzedni poniedziałek.

Przykład:

segments.date DURING LAST_30_DAYS

Wstępnie zdefiniowany okres

Niektóre pola daty odnoszą się do wstępnie zdefiniowanego okresu, a konkretnie:

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

Podczas filtrowania tych segmentów za pomocą niestandardowych ciągów znaków daty (przy użyciu =, BETWEEN, >=, <=, > lub <) musisz podać datę, która jest pierwszym dniem okresu:

  • segments.week: poniedziałek danego tygodnia (np. '2026-05-04').
  • segments.month: pierwszy dzień miesiąca (YYYY-MM-01, na przykład '2026-05-01').
  • segments.quarter: pierwszy dzień kwartału kalendarzowego (YYYY-01-01, YYYY-04-01, YYYY-07-01 lub YYYY-10-01).

Jeśli podasz datę, która nie jest pierwszym dniem okresu, zwracany jest błąd QueryError.MISALIGNED_DATE_FOR_FILTER. Możesz też filtrować te segmenty za pomocą operatora DURING ze wstępnie zdefiniowanym zakresem dat.

Aby na przykład określić maj 2026 r., użyj tego warunku, podając pierwszy dzień tego miesiąca:

segments.month = '2026-05-01'

Limity okresu retrospekcji

Dostępność danych do raportu historycznego zależy od szczegółowości wybranych lub przefiltrowanych segmentów dat:

  • Szczegółowość dzienna, tygodniowa i godzinowa (segments.date, segments.week i segments.hour): obsługuje okres ważności do 37 miesięcy. Zapytania, które dzielą dane na segmenty według segments.date, segments.week lub segments.hour (lub filtrują według zakresu dat krótszego niż miesiąc) w przypadku dat wykraczających poza 37-miesięczny okres, kończą się niepowodzeniem i zwracają błąd DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED w wersji 24 i nowszych (lub DateRangeError.UNKNOWN w wersji 23).
  • Szczegółowość miesięczna, kwartalna, roczna lub bez podziału na segmenty (segments.month, segments.quarter, segments.year lub bez segmentu daty): obsługuje dane historyczne z maksymalnie 11 lat. Aby wysłać zapytanie o dane historyczne spoza 37-miesięcznego okresu, posegmentuj dane według wymiaru segments.month, segments.quarter lub segments.year albo pomiń segmenty dat w SELECT i upewnij się, że zakres dat WHERE zaczyna się pierwszego dnia miesiąca i kończy ostatniego dnia miesiąca (lub filtruje według wymiaru segments.month, segments.quarter lub segments.year).
Wstecz
Struktura zapytania
Dalej
Rozróżnianie wielkości liter