صِفْرْ

يوضِّح هذا الدليل سبب ظهور الصفوف التي تتضمّن مقاييس صفرية في تقارير Google Ads API وكيفية استبعادها أو التعامل معها في طلبات البحث.

المقاييس الصفرية في نتائج البحث

عند تنفيذ طلب بحث، قد تصادف مقاييس للكيانات تكون قيمتها صفرًا. قد يرجع السبب إلى ما يلي:

• الكيانات غير مؤهَّلة للعرض.
• تم إيقافها مؤقتًا خلال النطاق الزمني للتقرير.

عند الحصول على نتائج طلب البحث، غالبًا ما تريد الحصول على معلومات حول أداء حملاتك. في هذا السياق، قد لا تكون المقاييس الصفرية مرغوبة. لإنشاء تقرير أكثر فائدة، يمكنك استبعاد المقاييس الصفرية بشكلٍ صريح.

استبعاد المقاييس الصفرية باستخدام دالة منطقية

الدالة المنطقية هي تعبير يتم تقييمه على أنّه TRUE أو FALSE أو UNKNOWN. تُستخدَم الدوال المنطقية في شرط البحث لعبارات WHERE في لغة طلبات بحث إعلانات Google.

يوضِّح طلب البحث التالي كيفية إزالة المقاييس الصفرية بشكلٍ صريح باستخدام دالة منطقية:

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). راجِع النطاقات الزمنية للاطّلاع على التفاصيل.