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

בשפת השאילתות של 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).