אפס מדדים

במדריך הזה מוסבר למה שורות עם מדדים אפסיים מופיעות בדוחות של Google Ads API ואיך להחריג אותן או לטפל בהן בשאילתות.

אפס מדדים בתוצאות החיפוש

כשמריצים שאילתה, יכול להיות שתיתקלו במדדים של ישויות שהערך שלהם הוא אפס. הסיבה לכך יכולה להיות:

• הישויות לא עומדות בדרישות להצגה.
• הן הושהו בטווח התאריכים של הדוח.

בעזרת תוצאות של שאילתות, אפשר לקבל מידע על הביצועים של הקמפיינים. בהקשר הזה, יכול להיות שלא תרצו לראות מדדים עם ערך אפס. כדי ליצור דוח שימושי יותר, אפשר להחריג במפורש מדדים עם ערך אפס.

החרגה של מדדים עם ערך אפס באמצעות פסוקית תנאי

פרדיקט הוא ביטוי שהערך המחושב שלו הוא TRUE,‏ FALSE או UNKNOWN. פרדיקטים משמשים בתנאי החיפוש של סעיפי WHERE בשפת השאילתות של Google Ads.

בדוגמה הבאה אפשר לראות איך מסירים במפורש מדדים עם ערך אפס באמצעות פסוקית תנאי:

SELECT
  campaign.id,
  metrics.impressions
FROM campaign
WHERE metrics.impressions > 0

החרגה של מדדים עם ערך אפס באמצעות פילוח

כשמפלחים דוח, המערכת תמיד מחריגה מדדים עם ערך אפס, בתנאי שכל המדדים שנבחרו הם אפס (ראו שורות שמוחזרות עם מדדים אפסיים).

כדי לפלח דוח, צריך לכלול שדה segments כלשהו בסעיף SELECT של שאילתת החיפוש (סינון לפי פלח תאריכים מרכזי ב-WHERE בלי לבחור אותו ב-SELECT לא יפלח את הדוח). לדוגמה, אם אתם מפלחים דוח לפי segments.date, המדדים מפורטים בשורה אחת לכל תאריך. תאריכים ללא מדדים לא מוחזרים בדוח כזה.

בדוגמה הבאה, הדוח לא יכלול שורות עם ערך אפס במדד:

SELECT
  campaign.name,
  metrics.impressions,
  segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

שורות שהוחזרו עם מדדים שהערך שלהם הוא אפס

כשמפלחים, לא מוחזרות שורות שבהן כל המדדים שנבחרו הם אפס. לדוגמה, נבחן את השאילתה הבאה שבוחרת את metrics.impressions,‏ metrics.clicks ו-metrics.conversions:

SELECT
  ad_group_criterion.criterion_id,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  segments.date
FROM keyword_view
WHERE segments.date BETWEEN '2026-01-01' AND '2026-01-31'

הדוח שיתקבל לא יכיל שורות שבהן כל שלושת המדדים שנבחרו הם אפס, אבל הוא יכיל שורות שבהן לפחות אחד משלושת המדדים שנבחרו גדול מאפס.

כשמריצים שאילתות על נתונים היסטוריים שחורגים מתקופת שמירת הנתונים, נתונים מפורטים מלפני יותר מ-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 שנים, בהתאם לתחילת התקופה המלאה הבאה ביומן. לדוגמה, אם תאריך הסיום של תקופת ההסתכלות לאחור של 11 שנים חל ב-2015-03-22 (או ב-2015-03-01), הנתונים החודשיים זמינים החל מהחודש הקלנדרי המלא הראשון אחרי תאריך הסיום (2015-04-01). פרטים נוספים זמינים במאמר בנושא טווח תאריכים.