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 dönemler, UTC veya API istemcisinin yerel saat dilimi yerine reklam sunma hesabının 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 açısından 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.
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 ayın tüm günleri.
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. Örneğin:

• 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ı (ör. segments.year = 2026) kullanılarak filtrelenir.

Geçmişe yönelik inceleme 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): 37 aya kadar yeniden inceleme aralığını destekler. 37 aylık dönemin dışındaki tarihler için segments.date, segments.week veya segments.hour ölçütüne göre segmentlere ayıran (ya da bir aydan kısa bir tarih aralığına göre filtreleyen) sorgular, 24. ve sonraki sürümlerde DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (veya 23. sürümde DateRangeError.UNKNOWN) hatasıyla 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 dışındaki 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 çıkarı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.