Ngôn ngữ truy vấn của 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 theo định dạng mở rộng (YYYY-MM-DD) hoặc cơ bản (YYYYMMDD) của ISO 8601. Bạn nên sử 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 giá trị cố định của phạm vi ngày được xác định trước. 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 bao gồm hôm nay. |
LAST_30_DAYS |
30 ngày qua, không tính 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 giữa thứ Hai tuần trước và 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 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 được xác định trước
Một số trường ngày đề cập đến một khoảng thời gian được xác định trước, cụ thể là:
segments.weeksegments.monthsegments.quarter
Khi lọc theo các phân đoạn 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ý theo 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 kỳ, thì hệ thống sẽ trả về lỗi QueryError.MISALIGNED_DATE_FOR_FILTER.
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'
Giới hạn về giai đoạn xem lại trong quá khứ
Phạm vi cung cấp dữ liệu báo cáo trước đây phụ thuộc vào mức độ chi tiết của các phân đoạn ngày được chọn hoặc lọ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 lên đến 37 tháng. Những truy vấn phân đoạn theosegments.date,segments.weekhoặcsegments.hour(hoặc lọc theo phạm vi ngày dưới một tháng) cho những ngày nằm ngoài khoảng thời gian 37 tháng sẽ không thành công và trả về lỗiDateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTEDtrong phiên bản 24 trở lên (hoặcDateRangeError.UNKNOWNtrong phiên bản 23). - Mức độ 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 trong quá khứ. Để truy vấn dữ liệu trong quá khứ ngoài khoảng thời gian 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 trongSELECT, đồng thời đảm bảo phạm vi ngàyWHEREbắt đầu vào ngày đầu tiên của tháng và kết thúc vào ngày cuối cùng của tháng (hoặc lọc theosegments.month,segments.quarterhoặcsegments.year).