Phạm vi ngày

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 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.week
  • segments.month
  • segments.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-01 hoặc YYYY-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.week và 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 theo segments.date, segments.week hoặc segments.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ỗi DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED trong phiên bản 24 trở lên (hoặc DateRangeError.UNKNOWN trong 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.year hoặ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 theo segments.month, segments.quarter, segments.year hoặc bỏ qua các phân đoạn ngày trong SELECT, đồng thời đảm bảo phạm vi ngày WHERE bắ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 theo segments.month, segments.quarter hoặc segments.year).