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

שפת השאילתות של Google Ads מאפשרת לציין את טווח התאריכים בדרכים הבאות:

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

אפשר לציין תאריכים בפורמט 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 ‫7 הימים האחרונים, לא כולל היום.
LAST_BUSINESS_WEEK שבוע העסקים בן 5 הימים, מיום שני עד יום שישי, של שבוע העסקים הקודם.
THIS_MONTH כל הימים בחודש הנוכחי.
LAST_MONTH כל הימים בחודש הקודם.
LAST_14_DAYS ‫14 הימים האחרונים, לא כולל היום.
LAST_30_DAYS ‫30 הימים האחרונים, לא כולל היום.
THIS_WEEK_SUN_TODAY התקופה שבין יום ראשון הקודם לבין היום הנוכחי.
THIS_WEEK_MON_TODAY התקופה שבין יום שני הקודם לבין היום הנוכחי.
LAST_WEEK_SUN_SAT תקופה של 7 ימים שמתחילה ביום ראשון הקודם.
LAST_WEEK_MON_SUN תקופה של 7 ימים שמתחילה ביום שני הקודם.

דוגמה:

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).