«زبان پُرسمان Google Ads» به شما امکان می‌دهد محدوده تاریخ را به این روش‌ها مشخص کنید:
محدوده تاریخ سفارشی
می‌توانید تاریخ‌ها را در قالب گسترده (YYYY-MM-DD) یا پایه (YYYYMMDD) ISO 8601 مشخص کنید. قالب گسترده (YYYY-MM-DD) برای خوانایی توصیه می‌شود. از BETWEEN یا عملگرهای
مقایسه (=، >، >=، <، <=) با رشته‌های تاریخ سفارشی استفاده کنید:
segments.date BETWEEN '2026-01-01' AND '2026-01-31'
segments.date >= '20260701' AND segments.date <= '20260731'
محدوده تاریخ ازپیش تعریف‌شده
از عملگر DURING با ثابت‌های محدوده تاریخ ازپیش تعریف‌شده استفاده کنید. عملگر DURING فقط از محدوده‌های تاریخ ازپیش تعریف‌شده پشتیبانی می‌کند و نمی‌توان از آن با رشته‌های تاریخ سفارشی استفاده کرد.
فهرست محدوده تاریخ‌های ازپیش تعریف‌شده معتبر به‌شرح زیر است:
| محدوده تاریخ | گزارش‌ها برای موارد زیر تولید می‌شوند… |
|---|---|
TODAY |
فقط امروز. |
YESTERDAY |
فقط دیروز. |
LAST_7_DAYS |
۷ روز گذشته بدون احتساب امروز. |
LAST_BUSINESS_WEEK
|
هفته کاری ۵ روزه، دوشنبه تا جمعه، هفته کاری گذشته. |
THIS_MONTH |
همه روزهای ماه جاری. |
LAST_MONTH |
همه روزهای ماه گذشته. |
LAST_14_DAYS |
۱۴ روز گذشته بدون احتساب امروز. |
LAST_30_DAYS |
۳۰ روز گذشته بدون احتساب امروز. |
THIS_WEEK_SUN_TODAY
|
دوره بین یکشنبه گذشته و روز جاری. |
THIS_WEEK_MON_TODAY
|
دوره بین دوشنبه گذشته و روز جاری. |
LAST_WEEK_SUN_SAT |
دوره ۷ روزهای که از یکشنبه گذشته شروع می‌شود. |
LAST_WEEK_MON_SUN |
دوره ۷ روزهای که از دوشنبه قبل شروع می‌شود. |
مثال:
segments.date DURING LAST_30_DAYS
دوره زمانی ازپیش تعریف‌شده
برخی فیلدهای تاریخ به دوره زمانی ازپیش تعریف‌شده‌ای اشاره دارند، به‌ویژه:
segments.weeksegments.monthsegments.quarter
هنگام فیلتر کردن این بخش‌ها با رشته‌های تاریخ سفارشی (بااستفاده از =، BETWEEN،
>=، <=، >، یا <)، باید تاریخی را مشخص کنید که اولین روز
دوره زمانی باشد:
-
segments.week: دوشنبه هفته (برای مثال،'2026-05-04'). segments.month: اولین روز ماه (YYYY-MM-01، برای مثال،'2026-05-01').segments.quarter: اولین روز سه‌ماهه تقویم (YYYY-01-01،YYYY-04-01،YYYY-07-01، یاYYYY-10-01).
اگر تاریخی را مشخص کنید که اولین روز دوره نباشد، خطای
QueryError.MISALIGNED_DATE_FOR_FILTER برگردانده می‌شود.
همچنین می‌توانید این بخش‌ها را بااستفاده از عملگر DURING با محدوده تاریخ ازپیش تعریف‌شده فیلتر کنید.
برای مثال، برای مشخص کردن ماه مه در سال ۲۰۲۶، از شرط زیر استفاده کنید و اولین روز آن ماه را مشخص کنید:
segments.month = '2026-05-01'
محدودیت‌های بازنگری تاریخی
دردسترس بودن داده‌های گزارش‌دهی قدیمی به جزئیات بخش‌های تاریخ انتخاب‌شده یا فیلترشده بستگی دارد:
- جزئیات روزانه، هفتگی، و ساعتی (
segments.date،segments.week، وsegments.hour): از پنجره بازگشتی تا ۳۷ ماه پشتیبانی می‌کند. پرس‌وجوهایی که براساسsegments.date،segments.week، یاsegments.hourبخش‌بندی می‌کنند (یا براساس محدوده تاریخ کمتر از یک ماه فیلتر می‌کنند) برای تاریخ‌های فراتر از پنجره ۳۷ ماهه باDateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTEDدر نسخه ۲۴ و جدیدتر (یاDateRangeError.UNKNOWNدر نسخه ۲۳) ناموفق می‌شوند. - دقت ماهانه، فصلی، سالانه، یا بخش‌بندی‌نشده (
segments.month،segments.quarter،segments.year، یا بدون بخش تاریخ): تا ۱۱ سال داده‌های سابقه را پشتیبانی می‌کند. برای جستجوی داده‌های قدیمی فراتر از پنجره ۳۷ ماهه، براساسsegments.month،segments.quarter،segments.yearبخش‌بندی کنید یا بخش‌های تاریخ را درSELECTحذف کنید و مطمئن شوید که محدوده تاریخWHEREدر اولین روز ماه شروع می‌شود و در آخرین روز ماه پایان می‌یابد (یا براساسsegments.month،segments.quarter، یاsegments.yearفیلتر کنید).