Zakresy dat

Język zapytań Google Ads umożliwia określanie zakresu dat w ten sposób:

Niestandardowy zakres dat

Daty możesz podawać w formacie ISO 8601 w wersji rozszerzonej (YYYY-MM-DD) lub podstawowej (YYYYMMDD). Dla lepszej czytelności zalecamy format rozszerzony (YYYY-MM-DD). Używaj operatorów BETWEEN lub 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żyj operatora DURING z 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.

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, z wyłączeniem dnia dzisiejszego.
THIS_WEEK_SUN_TODAY Okres od poprzedniej niedzieli do bieżącego dnia.
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 mianowicie:

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

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

  • segments.week: poniedziałek w danym tygodniu (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, zwracany jest błąd QueryError.MISALIGNED_DATE_FOR_FILTER. Możesz też filtrować te segmenty za pomocą operatora DURING z 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 wstecznego

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

  • 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 (lub filtrują według zakresu dat w okresie krótszym 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).
  • Dane miesięczne, kwartalne, roczne lub bez podziału na segmenty (segments.month, segments.quarter, segments.year lub bez segmentu daty): obsługuje do 11 lat danych historycznych. Aby wysyłać zapytania o dane historyczne wykraczające poza 37-miesięczny okres, segmentuj dane według segments.month, segments.quarter, segments.year lub pomiń segmenty dat w SELECT i upewnij się, że WHEREzakres dat rozpoczyna się pierwszego dnia miesiąca, a kończy ostatniego dnia miesiąca (lub filtruj dane według segments.month, segments.quarter lub segments.year).
Wstecz
Struktura zapytania
Dalej
Rozróżnianie wielkości liter