أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المقاييس التي تبلغ قيمتها صفرًا في نتائج البحث
عند تنفيذ طلب بحث، قد تصادف مقاييس لقيم صفرية. قد يرجع السبب إلى ما يلي:
الكيانات غير مؤهَّلة للعرض.
من المحتمل أنّه تم إيقافها مؤقتًا ضمن النطاق الزمني للتقرير.
عند استخدام نتائج طلب البحث، غالبًا ما تريد الحصول على معلومات حول مستوى أداء حملاتك. في هذا السياق، قد لا تكون المقاييس التي تبلغ قيمتها صفرًا مرغوبًا فيها. لإنشاء تقرير أكثر فائدة، يمكنك استبعاد المقاييس التي تبلغ قيمتها صفرًا بشكل صريح.
استبعاد المقاييس التي تبلغ قيمتها صفرًا باستخدام دالة منطقية
العبارة الشرطية هي تعبير يتم تقييمه على أنّه TRUE أو FALSE أو UNKNOWN.
ويتم استخدامها في شرط البحث الخاص بعبارات WHERE في Search Ads 360 Reporting API.
يوضّح طلب البحث التالي كيفية إزالة المقاييس التي تبلغ قيمتها صفرًا بشكل صريح باستخدام دالة مسند:
استبعاد المقاييس التي تبلغ قيمتها صفرًا من خلال التقسيم
يتم دائمًا استبعاد المقاييس التي تبلغ قيمتها صفرًا عند تقسيم التقرير، شرط أن تكون جميع المقاييس المحدّدة صفرًا (راجِع أدناه).
يتم تقسيم التقرير من خلال تضمين أي حقل segments في طلب البحث. على سبيل المثال، إذا قسّمت تقريرًا حسب segments.date، سيتم تقسيم المقاييس مع صف واحد لكل تاريخ. لا يتم عرض التواريخ التي لا تتضمّن مقاييس في هذا النوع من التقارير.
بالنسبة إلى الاستعلام التالي، لن يتضمّن التقرير صفوف المقاييس التي تبلغ قيمتها صفرًا:
تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eZero metrics in Search Ads 360 reports can indicate ineligible entities or paused entities within the report's timeframe.\u003c/p\u003e\n"],["\u003cp\u003eYou can refine your reports by explicitly excluding zero metrics using a predicate in the \u003ccode\u003eWHERE\u003c/code\u003e clause, ensuring that only meaningful data is displayed.\u003c/p\u003e\n"],["\u003cp\u003eSegmenting reports by fields like \u003ccode\u003esegments.date\u003c/code\u003e automatically removes zero metric rows when all selected metrics are zero for a particular segment.\u003c/p\u003e\n"],["\u003cp\u003eBy default, Search Ads 360 reports exclude rows with zero values for all selected metrics, simplifying report analysis and focusing on significant data points.\u003c/p\u003e\n"]]],["Zero metrics in search results can occur due to ineligibility or pausing. To exclude them and generate more useful reports, use predicates in the `WHERE` clause, like `metrics.impressions \u003e 0`. Alternatively, segmenting the report by any `segments` field, such as `segments.date`, automatically excludes rows where all selected metrics are zero. By default, rows with zero metrics for all *selected* metrics are omitted from reports, but this does not apply to Custom Columns.\n"],null,["# Zero Metrics\n\nZero metrics in search results\n------------------------------\n\nWhen you execute a query, you may encounter metrics for entities that\nare zero. This could be because:\n\n- The entities are ineligible for display.\n- They could have been paused within the report's date range.\n\nWith query results, you often want to obtain information about how your\ncampaigns are performing. In this context, zero metrics may not be\ndesirable. To produce a more useful report, you can explicitly exclude zero\nmetrics.\n\nExclude zero metrics with a predicate\n-------------------------------------\n\nA predicate is an expression that evaluates to `TRUE`, `FALSE`, or `UNKNOWN`.\nThey are used in the search condition of the `WHERE` clauses in\n[Search Ads 360 Reporting API](/search-ads/reporting/query/query-language#where_clause).\n\nThe following query demonstrates how to explicitly remove zero metrics with\na predicate: \n\n SELECT\n campaign.id,\n metrics.impressions\n FROM campaign\n WHERE metrics.impressions \u003e 0\n\nExclude zero metrics by segmenting\n----------------------------------\n\nZero metrics are always excluded when segmenting a report, provided all\n*selected* metrics are zero (see [below](#rows_returned)).\n\nSegmenting a report is done by including any `segments` field in the search\nquery. For example, if you segment a report by `segments.date`, metrics are\nbroken down with one row for each date. Dates with no metrics are not returned\nin such a report.\n\nFor the following query, the report won't include zero metric rows: \n\n SELECT\n campaign.name,\n metrics.impressions,\n segments.date\n FROM campaign\n WHERE segments.date DURING LAST_30_DAYS\n\nReturned rows with zero metrics\n-------------------------------\n\nRows for which a query returns zero metrics for **all** selected metrics are\nexcluded from your reports by default. Custom Columns don't apply.\n\nIn this example query, if there are no `impressions` metrics for any day in the\nlast 30 days, the row for that day will be omitted from the report. \n\n SELECT\n campaign.name,\n metrics.impressions,\n segments.date\n FROM campaign\n WHERE segments.date DURING LAST_30_DAYS\n\nIn this example query, the row for any day will only be excluded from your\nresults if there are zero `impressions`, `clicks` **and** `conversions` metrics\nfor that day. \n\n SELECT\n campaign.name,\n metrics.impressions,\n metrics.clicks,\n metrics.conversions,\n segments.date\n FROM campaign\n WHERE segments.date DURING LAST_30_DAYS"]]