טווחי תאריכים

בשפת השאילתות של 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 תומך רק בטווחים מוגדרים מראש של תאריכים, ואי אפשר להשתמש בו עם מחרוזות תאריכים בהתאמה אישית.

הרשימה הבאה מציגה את טווחי התאריכים המוגדרים מראש שניתן להשתמש בהם:

דוגמה:

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 עם טווח תאריכים מוגדר מראש.

לדוגמה, כדי לציין את חודש מאי בשנת 2026, משתמשים בתנאי הבא ומציינים את היום הראשון של אותו חודש:

segments.month = '2026-05-01'

מגבלות על נתונים היסטוריים

הזמינות של נתוני דיווח היסטוריים תלויה ברמת הפירוט של פלחי התאריכים שנבחרו או סוננו:

• רמת פירוט יומית, שבועית ושעתית (segments.date,‏ segments.week ו-segments.hour): תומכת בחלון מבט לאחור של עד 37 חודשים. שאילתות שמפלחים לפי segments.date, segments.week או segments.hour (או מסננים לפי טווח תאריכים של פחות מחודש) לתאריכים שחורגים מחלון 37 החודשים נכשלות עם DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED בגרסה 24 ואילך (או DateRangeError.UNKNOWN בגרסה 23).
• רמת פירוט חודשית, רבעונית, שנתית או ללא פילוח (segments.month, segments.quarter, segments.year או ללא פילוח לפי תאריך): תומך בנתונים היסטוריים של עד 11 שנים. כדי לשלוח שאילתה לנתונים היסטוריים מעבר לחלון של 37 חודשים, צריך לפלח לפי segments.month,‏ segments.quarter,‏ segments.year או להשמיט פלחים של תאריכים ב-SELECT, ולוודא שטווח התאריכים WHEREמתחיל ביום הראשון של חודש ומסתיים ביום האחרון של חודש (או מסננים לפי segments.month,‏ segments.quarter או segments.year).