سنجه‌های صفر

این راهنما توضیح می‌دهد که چرا ردیف‌های دارای سنجه‌های صفر در گزارش‌های 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'

گزارش حاصل حاوی ردیف‌هایی که هر سه سنجه انتخابی در آن‌ها صفر باشد نخواهد بود، اما ردیف‌هایی را که حداقل یکی از سه سنجه انتخابی در آن‌ها بزرگ‌تر از صفر باشد برمی‌گرداند.

هنگام پُرسمان داده‌های قدیمی فراتر از دوره حفظ داده‌ها، داده‌های دانه‌ای قدیمی‌تر از ۳۷ ماه دردسترس نیست و ردیف‌ها را برنمی‌گرداند. درخواست‌های بخش‌های تاریخ جزئی (segments.date، segments.week، و segments.hour) که محدوده‌های قدیمی‌تر از ۳۷ ماه را پوشش می‌دهند، در نسخه ۲۴ و جدیدتر DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (یا در نسخه ۲۳، DateRangeError.UNKNOWN) را برمی‌گردانند. داده‌های تجمیعی سطح بالا (segments.month،‏ segments.quarter، و segments.year) به‌مدت ۱۱ سال حفظ می‌شود که با شروع دوره تقویمی کامل بعدی مطابقت دارد. برای مثال، اگر حد آستانه ۱۱ ساله بازنگری در 2015-03-22 (یا 2015-03-01) باشد، داده‌های ماهانه از اولین ماه تقویمی کامل پس‌از حد آستانه (2015-04-01) دردسترس است. برای جزئیات، به محدوده‌های تاریخ مراجعه کنید.