صِفْرْ

يوضّح هذا الدليل سبب ظهور صفوف تتضمّن مقاييس بقيمة صفر في تقارير 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). راجِع النطاقات الزمنية للحصول على التفاصيل.