Ngôn ngữ truy vấn Google Ads cho phép bạn chỉ định phạm vi ngày theo những cách sau:
- Phạm vi ngày tuỳ chỉnh
- Phạm vi ngày được xác định trước
- Khoảng thời gian được xác định trước
- Hạn mức xem lại dữ liệu trong quá khứ
Phạm vi ngày tùy chỉnh
Bạn có thể chỉ định ngày ở định dạng ISO 8601 mở rộng (YYYY-MM-DD) hoặc cơ bản (YYYYMMDD). Bạn nên dùng định dạng mở rộng (YYYY-MM-DD) để dễ đọc. Sử dụng BETWEEN hoặc toán tử so sánh (=, >, >=, <, <=) với chuỗi ngày tuỳ chỉnh:
segments.date BETWEEN '2026-01-01' AND '2026-01-31'
segments.date >= '20260701' AND segments.date <= '20260731'
Phạm vi ngày được xác định trước
Sử dụng toán tử DURING với các giá trị cố định được xác định trước cho phạm vi ngày. Toán tử DURING chỉ hỗ trợ phạm vi ngày được xác định trước và không thể dùng với chuỗi ngày tuỳ chỉnh.
Dưới đây là danh sách các phạm vi ngày đặt trước hợp lệ:
| Phạm vi ngày | Báo cáo được tạo cho... |
|---|---|
TODAY |
Chỉ hôm nay. |
YESTERDAY |
Chỉ hôm qua. |
LAST_7_DAYS |
7 ngày qua, không tính ngày hôm nay. |
LAST_BUSINESS_WEEK
|
Tuần làm việc 5 ngày, từ thứ Hai đến thứ Sáu của tuần làm việc trước. |
THIS_MONTH |
Tất cả các ngày trong tháng hiện tại. |
LAST_MONTH |
Tất cả các ngày trong tháng trước. |
LAST_14_DAYS |
14 ngày qua, không tính ngày hôm nay. |
LAST_30_DAYS |
30 ngày qua, không tính ngày hôm nay. |
THIS_WEEK_SUN_TODAY
|
Khoảng thời gian từ Chủ Nhật tuần trước đến ngày hiện tại. |
THIS_WEEK_MON_TODAY
|
Khoảng thời gian từ thứ Hai tuần trước đến ngày hiện tại. |
LAST_WEEK_SUN_SAT |
Khoảng thời gian 7 ngày bắt đầu từ Chủ Nhật tuần trước. |
LAST_WEEK_MON_SUN |
Khoảng thời gian 7 ngày bắt đầu từ thứ Hai tuần trước. |
Ví dụ:
segments.date DURING LAST_30_DAYS
Khoảng thời gian định sẵn
Một số trường ngày đề cập đến một khoảng thời gian xác định trước, cụ thể là:
segments.weeksegments.monthsegments.quarter
Khi lọc trên các phân khúc này bằng chuỗi ngày tuỳ chỉnh (sử dụng =, BETWEEN, >=, <=, > hoặc <), bạn phải chỉ định ngày là ngày đầu tiên của khoảng thời gian:
segments.week: Thứ Hai của tuần (ví dụ:'2026-05-04').segments.month: Ngày đầu tiên của tháng (ví dụ:YYYY-MM-01,'2026-05-01').segments.quarter: Ngày đầu tiên của quý trong lịch (YYYY-01-01,YYYY-04-01,YYYY-07-01hoặcYYYY-10-01).
Nếu bạn chỉ định một ngày không phải là ngày đầu tiên của khoảng thời gian, thì lỗi QueryError.MISALIGNED_DATE_FOR_FILTER sẽ được trả về.
Bạn cũng có thể lọc các phân khúc này bằng cách sử dụng toán tử DURING với một phạm vi ngày được xác định trước.
Ví dụ: để chỉ định tháng 5 năm 2026, hãy sử dụng điều kiện sau, chỉ định ngày đầu tiên của tháng đó:
segments.month = '2026-05-01'
Hạn mức xem lại dữ liệu trong quá khứ
Khả năng cung cấp dữ liệu báo cáo trước đây phụ thuộc vào độ chi tiết của các phân đoạn ngày được chọn hoặc được lọc:
- Mức độ chi tiết hằng ngày, hằng tuần và hằng giờ (
segments.date,segments.weekvàsegments.hour): Hỗ trợ giai đoạn xem lại tối đa 37 tháng. Những truy vấn phân đoạn theosegments.date,segments.weekhoặcsegments.hour(hoặc lọc theo một dải ngày nhỏ hơn một tháng) cho những ngày ngoài khoảng thời gian 37 tháng sẽ không thành công vớiDateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTEDtrong phiên bản 24 trở lên (hoặcDateRangeError.UNKNOWNtrong phiên bản 23). - Độ chi tiết hằng tháng, hằng quý, hằng năm hoặc không phân đoạn (
segments.month,segments.quarter,segments.yearhoặc không có phân đoạn ngày): Hỗ trợ tối đa 11 năm dữ liệu cũ. Để truy vấn dữ liệu cũ hơn 37 tháng, hãy phân đoạn theosegments.month,segments.quarter,segments.yearhoặc bỏ qua các phân đoạn ngày trongSELECTvà đảm bảo phạm vi ngàyWHEREbắt đầu từ ngày đầu tiên của một tháng và kết thúc vào ngày cuối cùng của một tháng (hoặc lọc theosegments.month,segments.quarterhoặcsegments.year).