אפס מדדים

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

הסתרת מדדי החשיפה וערכי אפס

בנוסף לישויות שלא הציגו חשיפות של מודעות שהוצגו, מדדי החשיפה (כמו metrics.unique_users ומדדי קטגוריות התדירות metrics.unique_users_two_plus עד metrics.unique_users_ten_plus) יכולים להופיע כ-0 או לא להופיע בכלל אם נתוני היקף החשיפה מושמטים. המדד metrics.unique_users (וגם metrics.unique_users_info) נתמך בקמפיינים לרשת המדיה, בקמפיינים של מודעות וידאו, בקמפיינים ליצירת ביקוש ובקמפיינים לקידום אפליקציות, ואילו המדדים של קטגוריית התדירות metrics.unique_users_*_plus (וגם metrics.unique_users_*_plus_info) חלים על קמפיינים של מודעות וידאו.

יש כמה סיבות להגבלת פוטנציאל החשיפה:

• ערכי סף להגנה על הפרטיות: כדי להגן על זהות המשתמשים, נתוני היקף החשיפה לא מוצגים כשמספר המשתמשים לא עומד בערכי הסף להגנה על הפרטיות (כמו k-anonymity).
• ספי איכות: יכול להיות שנתוני היקף החשיפה לא יוצגו אם הם לא עומדים בתקני האיכות.
• שמירת נתונים: נתוני היקף החשיפה ההיסטוריים נשמרים למשך 3 שנים (36 חודשים). שאילתות שכוללות תאריכים שחורגים מתקופת השמירה של 3 שנים לא יכולות להחזיר מדדי חשיפה. שאילתות שכוללות תאריכים מלפני 36 עד 37 חודשים יצליחו בלי להחזיר את השגיאה DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED שמתוארת בקטע הקודם, אבל הן ישמיטו את מדדי החשיפה (ויחזירו את השגיאה DATE_RANGE_BEYOND_RETENTION אם נבחרו מטא-נתונים נלווים של היקף החשיפה).

בגרסה 26 ואילך, לכל מדד חשיפה למשתמשים ייחודיים יש שדה מטא-נתונים נלווה מסוג ReachMetricInfo (למשל metrics.unique_users_info ו-metrics.unique_users_two_plus_info עד metrics.unique_users_ten_plus_info).

בשפת השאילתות של Google Ads‏ (GAQL), שדות של פוטנציאל החשיפה של מודעות נלוות הם מדדים של MESSAGE שנבחרים ישירות בסעיף SELECT (לדוגמה, metrics.unique_users_info). אל תוסיפו את .reach_metric_states בסעיף SELECT, כי בחירה של שדות הודעות בתצוגת עץ ב-GAQL נכשלת עם UNRECOGNIZED_FIELD. במקום זאת, בחירה באפשרות metrics.unique_users_info מחזירה הודעת ReachMetricInfo שמכילה את שדה ה-enum החוזר reach_metric_states מסוג ReachMetricState, שמתאר אם המדד הושמט או שהוא מלא.

בכל פעם שמדד החשיפה מושמט או נמצא מחוץ לחלון השמירה (PRIVACY_SUPPRESSION,‏ QUALITY_SUPPRESSION או DATE_RANGE_BEYOND_RETENTION), השדה optional int64 שלו ב-Metrics לא מוגדר (הערך שלו הוא 0 אם לא בודקים את נוכחות השדה), ואילו LOW_QUALITY עדיין מאכלס את המדד המספרי:

• ‫COMPLETE: מדד החשיפה הושלם במלואו ללא השמטה.
• ‫PRIVACY_SUPPRESSION: נתוני היקף החשיפה הוסתרו בגלל אילוצי פרטיות.
• ‫QUALITY_SUPPRESSION: נתוני היקף החשיפה הוסתרו בגלל איכות הנתונים.
• LOW_QUALITY: מדד החשיפה חושב אבל סומן כאיכות נמוכה.
• DATE_RANGE_BEYOND_RETENTION: מדדי החשיפה לא זמינים כי טווח התאריכים חורג ממגבלת שמירת הנתונים של 3 שנים לנתוני חשיפה.

אם תבחרו גם את מדד החשיפה וגם את שדה המטא-נתונים הנלווה, האפליקציה תוכל להבחין בין ערכי חשיפה שהם באמת אפס לבין ערכים שהוסתרו:

SELECT
  campaign.id,
  campaign.name,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

הערה: שדות המטא-נתונים של היקף החשיפה של המודעה הנלווית (metrics.unique_users*_info) הם מדדים מסוג MESSAGE עם filterable: false ו-sortable: false, ולכן אי אפשר להשתמש בהם בסעיפים WHERE או ORDER BY. בנוסף, אי אפשר לצבור את מדדי החשיפה בשורות. אפשר לבקש את המדד metrics.unique_users רק לטווחי תאריכים של 92 ימים או פחות, ואת המדדים של קטגוריית התדירות unique_users_*_plus רק לטווחי תאריכים של 31 ימים או פחות. הרשימה המלאה של מדדי היקף החשיפה והתדירות של מודעות וידאו מפורטת במאמר דיווח על היקף החשיפה והתדירות של קמפיינים.