Tarih aralıkları

Google Ads Sorgu Dili, tarih aralığını şu şekillerde belirtmenize olanak tanır:

• Özel tarih aralığı
• Önceden tanımlanmış tarih aralığı
• Önceden tanımlanmış dönem
• Geçmişe yönelik inceleme sınırları

Not: Tüm tarih aralıkları ve zaman dönemleri, UTC veya API istemcisinin yerel saat dilimi yerine yayın hesabı saat dilimine (customer.time_zone) göre değerlendirilir.

Özel tarih aralığı

Tarihleri ISO 8601 genişletilmiş (YYYY-MM-DD) veya temel (YYYYMMDD) biçimde belirtebilirsiniz. Okunabilirlik için genişletilmiş biçim (YYYY-MM-DD) önerilir. Özel tarih dizeleriyle BETWEEN veya karşılaştırma operatörlerini (=, >, >=, <, <=) kullanın:

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

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

Önceden tanımlanmış tarih aralığı

Önceden tanımlanmış tarih aralığı değişmezleriyle DURING operatörünü kullanın. DURING operatörü yalnızca önceden tanımlanmış tarih aralıklarını destekler ve özel tarih dizeleriyle kullanılamaz.

Geçerli önceden tanımlanmış tarih aralıklarının listesi aşağıdaki gibidir:

Tarih aralığı	Raporlar şu tarihler için oluşturulur:
TODAY	Yalnızca bugün geçerlidir.
YESTERDAY	Yalnızca dün.
LAST_7_DAYS	Bugün hariç son 7 gün.
LAST_BUSINESS_WEEK	Önceki iş haftasının pazartesiden cumaya kadar olan 5 günlük iş haftası.
THIS_MONTH	Geçerli aydaki tüm günler.
LAST_MONTH	Önceki ayın tüm günleri.
LAST_14_DAYS	Bugün hariç son 14 gün.
LAST_30_DAYS	Bugün hariç son 30 gün.
THIS_WEEK_SUN_TODAY	Önceki pazar günü ile geçerli gün arasındaki dönem.
THIS_WEEK_MON_TODAY	Önceki pazartesi ile geçerli gün arasındaki dönem.
LAST_WEEK_SUN_SAT	Önceki pazar günüyle başlayan 7 günlük dönem.
LAST_WEEK_MON_SUN	Önceki pazartesi günü başlayan 7 günlük dönem.

Örnek:

segments.date DURING LAST_30_DAYS

Önceden tanımlanmış dönem

Bazı tarih alanları, önceden tanımlanmış bir zaman aralığını ifade eder. Bu alanlar şunlardır:

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

Bu segmentleri özel tarih dizeleriyle (=, BETWEEN, >=, <=, > veya < kullanarak) filtrelerken dönemin ilk günü olan bir tarih belirtmeniz gerekir:

• segments.week: Haftanın pazartesi günü (ör. '2026-05-04').
• segments.month: Ayın ilk günü (ör. YYYY-MM-01, '2026-05-01').
• segments.quarter: Takvim çeyreğinin ilk günü (YYYY-01-01, YYYY-04-01, YYYY-07-01 veya YYYY-10-01).

Dönemin ilk günü olmayan bir tarih belirtirseniz QueryError.MISALIGNED_DATE_FOR_FILTER hatası döndürülür. Bu segmentleri, önceden tanımlanmış bir tarih aralığıyla DURING operatörünü kullanarak da filtreleyebilirsiniz.

Örneğin, 2026 yılının Mayıs ayını belirtmek için aşağıdaki koşulu kullanın ve ilgili ayın ilk gününü belirtin:

segments.month = '2026-05-01'

Not: segments.year, YYYY-MM-DD tarih dizesi yerine 4 haneli bir yıl tam sayısı (örneğin, segments.year = 2026) kullanılarak filtrelenir.

Geçmişe dönük bakma sınırları

Geçmiş raporlama verilerinin kullanılabilirliği, seçilen veya filtrelenen tarih segmentlerinin ayrıntı düzeyine bağlıdır:

• Günlük, haftalık ve saatlik ayrıntı düzeyi (segments.date, segments.week ve segments.hour): En fazla 37 aylık bir yeniden inceleme aralığını destekler. 37 aylık dönemin dışındaki tarihler için segments.date, segments.week veya segments.hour'ye göre segmentlere ayıran (ya da aylık dönemin altındaki bir tarih aralığına göre filtreleyen) sorgular, v24 ve sonraki sürümlerde DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (v23'te DateRangeError.UNKNOWN) ile başarısız olur.
• Aylık, üç aylık, yıllık veya segmentlere ayrılmamış ayrıntı düzeyi (segments.month, segments.quarter, segments.year veya tarih segmenti yok): 11 yıla kadar geçmiş verileri destekler. 37 aylık dönemin ötesindeki geçmiş verileri sorgulamak için segments.month, segments.quarter, segments.year ölçütüne göre segmentlere ayırın veya SELECT ölçütündeki tarih segmentlerini atlayın ve WHERE tarih aralığının bir ayın ilk günü başlayıp son günü bittiğinden (veya segments.month, segments.quarter ya da segments.year ölçütüne göre filtre uygulandığından) emin olun.