سنجه‌های صفر

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

این استثنا زمانی هم که فیلدهای segments (مثل فیلدهای segments.ad_network_type یا segments.device) را بدون انتخاب هیچ فیلد metrics انتخاب می‌کنید اعمال می‌شود. اگر نهادی صفر ظهور داشته باشد، پُرسمان بخش‌بندی‌شده آن نهاد را حذف می‌کند، حتی وقتی فقط مشخصه‌های منبع را انتخاب کنید، مثل فیلد campaign.network_settings.target_search_network. برای بازیابی تنظیمات منبع برای همه نهادها صرف‌نظر از تعداد ظهور، فیلدهای segments را از عبارت SELECT حذف کنید.

ردیف‌های برگردانده‌شده با سنجه‌های صفر

ردیف‌هایی که سنجه‌های انتخابی آن‌ها همگی صفر است هنگام بخش‌بندی برگردانده نخواهند شد. برای مثال، پُرسمان زیر را درنظر بگیرید که 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) دردسترس است. برای جزئیات، محدوده تاریخ را ببینید.

حذف سنجه دسترسی و مقادیر صفر

علاوه‌بر نهادهایی که ظهور نکرده‌اند، سنجه‌های دسترسی (مانند metrics.unique_users و سنجه‌های دسته فواصل زمانی metrics.unique_users_two_plus تا metrics.unique_users_ten_plus) می‌توانند به‌صورت صفر نشان داده شوند یا وقتی داده‌های دسترسی سرکوب می‌شوند، حذف شوند. سنجه metrics.unique_users (و metrics.unique_users_info) در پویش‌های «برنامه»، «تولید تقاضا»، «ویدیویی»، و «شبکه تبلیغات» پشتیبانی می‌شود، درحالی‌که سنجه‌های دسته فراوانی metrics.unique_users_*_plus (و metrics.unique_users_*_plus_info) برای پویش‌های «ویدیویی» اعمال می‌شود.

سرکوب دسترسی به چند دلیل اتفاق می‌افتد:

• آستانه‌های حریم خصوصی: وقتی تعداد کاربران به آستانه‌های حریم خصوصی (مانند k-گمنامی) نرسد، داده‌های دسترسی برای محافظت از هویت کاربر سرکوب می‌شود.
• آستانه‌های کیفیت: اگر داده‌ها استانداردهای کیفیت را برآورده نکنند، ممکن است داده‌های دسترسی ارائه نشوند.
• حفظ داده‌ها: داده‌های دسترسی گذشته به‌مدت ۳ سال (۳۶ ماه) حفظ می‌شود. پرس‌وجوهایی که تاریخ آن‌ها فراتر از این پنجره نگهداری ۳ ساله باشد نمی‌توانند سنجه‌های دسترسی را برگردانند. درحالی‌که پرسمان‌های پوشش‌دهنده تاریخ‌های بین ۳۶ و ۳۷ ماه پیش بدون برگرداندن DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED شرح‌داده‌شده در بخش قبلی موفق می‌شوند، سنجه‌های دسترسی را حذف می‌کنند (و DATE_RANGE_BEYOND_RETENTION را هنگام انتخاب فراداده دسترسی همراه برمی‌گردانند).

در نسخه ۲۶ و نسخه‌های جدیدتر، هر سنجه دسترسی کاربر منحصربه‌فرد دارای یک فیلد فراداده همراه از نوع ReachMetricInfo (مانند metrics.unique_users_info و metrics.unique_users_two_plus_info تا metrics.unique_users_ten_plus_info) است.

در Google Ads Query Language (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: سنجه‌های دسترسی دردسترس نیستند زیرا محدوده تاریخ خارج از حد مجاز ۳ ساله حفظ داده‌ها برای داده‌های دسترسی است.

با انتخاب سنجه دسترسی و فیلد فراداده همراه آن، برنامه شما می‌تواند بین دسترسی صفر واقعی و مقادیر دسترسی که سرکوب شده‌اند تمایز قائل شود:

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 را فقط می‌توان برای محدوده تاریخ ۹۲ روز یا کمتر درخواست کرد، درحالی‌که سنجه‌های دسته فراوانی unique_users_*_plus را فقط می‌توان برای محدوده تاریخ ۳۱ روز یا کمتر درخواست کرد. برای فهرست کامل سنجه‌های دسترسی و بسامد ویدیو، گزارش‌دهی دسترسی و بسامد پویش را ببینید.