زبان جستجوی گوگل ادز به شما امکان می‌دهد محدوده تاریخ را به این روش‌ها مشخص کنید:
- محدوده تاریخ سفارشی
- محدوده تاریخ از پیش تعریف شده
- دوره زمانی از پیش تعریف شده
- محدودیت‌های نگاهی به گذشته
محدوده تاریخ سفارشی
شما می‌توانید تاریخ‌ها را در قالب ISO 8601 توسعه‌یافته ( YYYY-MM-DD ) یا پایه ( YYYYMMDD ) مشخص کنید. قالب توسعه‌یافته ( 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.week -
segments.month -
segments.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، یا بدون تقسیم‌بندی تاریخ): از داده‌های تاریخی تا ۱۱ سال پشتیبانی می‌کند. برای جستجوی داده‌های تاریخی فراتر از بازه ۳۷ ماهه، درSELECTبر اساسsegments.month،segments.quarter،segments.yearتقسیم‌بندی کنید یا بخش‌های تاریخ را حذف کنید و مطمئن شوید که محدوده تاریخWHEREاز اولین روز ماه شروع می‌شود و در آخرین روز ماه پایان می‌یابد (یا فیلترها را رویsegments.month،segments.quarterیاsegments.yearاعمال کنید).