אפס מדדים

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