Rentang tanggal

Bahasa Kueri Google Ads memungkinkan Anda menentukan rentang tanggal dengan cara berikut:

Rentang tanggal khusus

Anda dapat menentukan tanggal dalam format ISO 8601 yang diperluas (YYYY-MM-DD) atau dasar (YYYYMMDD). Format yang diperluas (YYYY-MM-DD) direkomendasikan agar lebih mudah dibaca. Gunakan BETWEEN atau operator perbandingan (=, >, >=, <, <=) dengan string tanggal kustom:

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

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

Rentang tanggal yang telah ditentukan

Gunakan operator DURING dengan literal rentang tanggal yang telah ditentukan sebelumnya. Operator DURING hanya mendukung rentang tanggal yang telah ditentukan dan tidak dapat digunakan dengan string tanggal kustom.

Daftar rentang tanggal standar yang valid adalah sebagai berikut:

Rentang tanggal Laporan dibuat untuk...
TODAY Hanya hari ini.
YESTERDAY Hanya kemarin.
LAST_7_DAYS 7 hari terakhir tidak termasuk hari ini.
LAST_BUSINESS_WEEK Minggu kerja 5 hari, Senin hingga Jumat, dari minggu kerja sebelumnya.
THIS_MONTH Semua hari dalam bulan ini.
LAST_MONTH Semua hari pada bulan sebelumnya.
LAST_14_DAYS 14 hari terakhir tidak termasuk hari ini.
LAST_30_DAYS 30 hari terakhir tidak termasuk hari ini.
THIS_WEEK_SUN_TODAY Periode antara hari Minggu sebelumnya dan hari ini.
THIS_WEEK_MON_TODAY Periode antara hari Senin sebelumnya dan hari ini.
LAST_WEEK_SUN_SAT Periode 7 hari yang dimulai dengan hari Minggu sebelumnya.
LAST_WEEK_MON_SUN Periode 7 hari yang dimulai dengan hari Senin sebelumnya.

Contoh:

segments.date DURING LAST_30_DAYS

Jangka waktu yang telah ditentukan

Beberapa kolom tanggal mengacu pada jangka waktu yang telah ditentukan, khususnya:

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

Saat memfilter segmen ini dengan string tanggal kustom (menggunakan =, BETWEEN, >=, <=, >, atau <), Anda harus menentukan tanggal yang merupakan hari pertama jangka waktu:

  • segments.week: Hari Senin dalam seminggu (misalnya, '2026-05-04').
  • segments.month: Hari pertama dalam sebulan (YYYY-MM-01, misalnya, '2026-05-01').
  • segments.quarter: Hari pertama kuartal kalender (YYYY-01-01, YYYY-04-01, YYYY-07-01, atau YYYY-10-01).

Jika Anda menentukan tanggal yang bukan hari pertama periode, error QueryError.MISALIGNED_DATE_FOR_FILTER akan ditampilkan. Anda juga dapat memfilter segmen ini menggunakan operator DURING dengan rentang tanggal standar.

Misalnya, untuk menentukan bulan Mei tahun 2026, gunakan kondisi berikut, dengan menentukan hari pertama bulan tersebut:

segments.month = '2026-05-01'

Batas periode lihat historis

Ketersediaan data pelaporan historis bergantung pada perincian segmen tanggal yang dipilih atau difilter:

  • Perincian harian, mingguan, dan per jam (segments.date, segments.week, dan segments.hour): Mendukung periode lihat kembali hingga 37 bulan. Kueri yang melakukan segmentasi menurut segments.date, segments.week, atau segments.hour (atau memfilter rentang tanggal di bawah bulanan) untuk tanggal di luar periode 37 bulan akan gagal dengan DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED di v24 dan yang lebih baru (atau DateRangeError.UNKNOWN di v23).
  • Perincian bulanan, kuartalan, tahunan, atau tidak tersegmentasi (segments.month, segments.quarter, segments.year, atau tanpa segmen tanggal): Mendukung data historis hingga 11 tahun. Untuk membuat kueri data historis di luar periode 37 bulan, lakukan segmentasi menurut segments.month, segments.quarter, segments.year, atau hilangkan segmen tanggal di SELECT, dan pastikan rentang tanggal WHERE dimulai pada hari pertama bulan dan berakhir pada hari terakhir bulan (atau filter pada segments.month, segments.quarter, atau segments.year).
Sebelumnya
Struktur kueri
Berikutnya
Kepekaan huruf besar/kecil