Zakresy dat

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

Niestandardowy zakres dat

Daty możesz podać w formacie ISO 8601 rozszerzonym (YYYY-MM-DD) lub podstawowym (YYYYMMDD). Ze względu na czytelność zalecamy format rozszerzony (YYYY-MM-DD). Używaj BETWEEN lub operatorów porównania (=, >, >=, <, <=) z niestandardowymi ciągami dat:

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 z literałami wstępnie zdefiniowanego 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 Ostatnich 7 dni, z wyłączeniem dzisiaj.
LAST_BUSINESS_WEEK 5-dniowy tydzień pracy (od poniedziałku do piątku) poprzedniego tygodnia pracy.
THIS_MONTH Wszystkich dni w bieżącym miesiącu.
LAST_MONTH Wszystkich dni w poprzednim miesiącu.
LAST_14_DAYS Ostatnich 14 dni, z wyłączeniem dzisiaj.
LAST_30_DAYS Ostatnich 30 dni, z wyłączeniem dzisiaj.
THIS_WEEK_SUN_TODAY Okresu od poprzedniej niedzieli do bieżącego dnia.
THIS_WEEK_MON_TODAY Okresu od poprzedniego poniedziałku do bieżącego dnia.
LAST_WEEK_SUN_SAT 7-dniowego okresu rozpoczynającego się w poprzednią niedzielę.
LAST_WEEK_MON_SUN 7-dniowego okresu rozpoczynającego się w poprzedni poniedziałek.

Przykład:

segments.date DURING LAST_30_DAYS

Wstępnie zdefiniowany przedział czasu

Niektóre pola daty odnoszą się do wstępnie zdefiniowanego przedziału czasu, a konkretnie:

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

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

  • segments.week: poniedziałek tygodnia (np. '2026-05-04').
  • segments.month: pierwszy dzień miesiąca (YYYY-MM-01, np. '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, zostanie zwrócony 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 dotyczące danych historycznych

Dostępność danych do raportu historycznych zależy od szczegółowości wybranych lub filtrowanych segmentów daty:

  • Szczegółowość dzienna, tygodniowa i godzinowa (segments.date, segments.week i segments.hour): obsługuje okres wsteczny do 37 miesięcy. Zapytania, które segmentują według segments.date, segments.week lub segments.hour (albo filtrują według zakresu dat krótszego niż miesiąc) w przypadku dat wykraczających poza okres 37 miesięcy kończą się niepowodzeniem z powodu błędu 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 segmentacji (segments.month, segments.quarter, segments.year lub brak segmentu daty): obsługuje dane historyczne z okresu do 11 lat. Aby wysyłać zapytania o dane historyczne wykraczające poza okres 37 miesięcy, segmentuj według segments.month, segments.quarter lub segments.year albo pomiń segmenty daty w klauzuli SELECT i upewnij się, że zakres dat w klauzuli WHERE zaczyna się pierwszego dnia miesiąca i kończy ostatniego dnia miesiąca (albo filtruje według segments.month, segments.quarter lub segments.year).