জিরো মেট্রিক

এই নির্দেশিকা থেকে জানতে পারবেন যে Google Ads API রিপোর্টে কেন শূন্য মেট্রিক সহ সারি দেখা যায় এবং আপনার কোয়েরিতে কীভাবে সেগুলি বাদ দেবেন বা ম্যানেজ করবেন।

সার্চ ফলাফলে শূন্য মেট্রিক

আপনি কোনও কোয়েরি এক্সিকিউট করলে, এন্টিটির জন্য মেট্রিক শূন্য দেখতে পেতে পারেন। এইসব কারণে এটি হতে পারে:

• এন্টিটিগুলি দেখানোর জন্য উপযুক্ত নয়।
• রিপোর্টের তারিখের ব্যাপ্তির মধ্যে সেগুলি পজ করা হয়েছে।

কোয়েরি ফলাফলের সাথে, আপনি প্রায়ই আপনার ক্যাম্পেন কেমন পারফর্ম করছে সেই সম্পর্কে তথ্য পেতে চান। এই প্রসঙ্গে, শূন্য মেট্রিক কাম্য নাও হতে পারে। আরও উপযোগী রিপোর্ট তৈরি করতে, আপনি স্পষ্টভাবে শূন্য মেট্রিক বাদ দিতে পারেন।

প্রেডিকেট সহ শূন্য মেট্রিক বাদ দিন

প্রেডিকেট হল এমন একটি এক্সপ্রেশন যা TRUE, FALSE বা UNKNOWN-এর মান নির্ণয় করে। Google Ads কোয়েরি ল্যাঙ্গুয়েজ-এ WHERE ক্লজের সার্চ শর্তে প্রেডিকেট ব্যবহার করা হয়।

নিম্নলিখিত কোয়েরি থেকে বোঝা যায় যে কীভাবে প্রেডিকেট ব্যবহার করে স্পষ্টভাবে শূন্য মেট্রিক সরানো যায়:

SELECT
  campaign.id,
  metrics.impressions
FROM campaign
WHERE metrics.impressions > 0

সেগমেন্ট করার মাধ্যমে শূন্য মেট্রিক বাদ দিন

রিপোর্ট সেগমেন্ট করার সময় শূন্য মেট্রিক সবসময় বাদ দেওয়া হয়, তবে সব বেছে নেওয়া মেট্রিক শূন্য হতে হবে (দেখুন শূন্য মেট্রিক সহ রিটার্ন করা সারি)।

সার্চ কোয়েরির SELECT ক্লজে যেকোনও segments ফিল্ড অন্তর্ভুক্ত করে রিপোর্ট সেগমেন্ট করা হয় (SELECT-এ বেছে না নিয়ে WHERE-এ কোর ডেট সেগমেন্টে ফিল্টার করলে রিপোর্ট সেগমেন্ট করা হয় না)। যেমন, আপনি যদি 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) জন্য করা অনুরোধ v24 এবং তার পরের ভার্সনে DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (বা v23-এ 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 ফিরিয়ে দেয় যখন কম্প্যানিয়ন রিচ মেটাডেটা বেছে নেওয়া হয়)।

v26 এবং তার পরবর্তী ভার্সনে, প্রতিটি অনন্য ব্যবহারকারীর রিচ মেট্রিকের একটি সহযোগী মেটাডেটা ফিল্ড আছে যার ধরন হল ReachMetricInfo (যেমন metrics.unique_users_info এবং metrics.unique_users_two_plus_info থেকে metrics.unique_users_ten_plus_info)।

Google Ads কোয়েরি ল্যাঙ্গুয়েজে (GAQL), কম্প্যানিয়ন রিচ ফিল্ড হল MESSAGE মেট্রিক যা সরাসরি SELECT ক্লজে বেছে নেওয়া হয় (যেমন, metrics.unique_users_info)। SELECT ক্লজে .reach_metric_states যোগ করবেন না, কারণ GAQL-এ নেস্টেড মেসেজ ফিল্ড বেছে নিলে UNRECOGNIZED_FIELD-এর সাথে ব্যর্থ হয়। পরিবর্তে, metrics.unique_users_info বেছে নিলে একটি ReachMetricInfo মেসেজ রিটার্ন করে যাতে ReachMetricState ধরনের রিপিট করা enum ফিল্ড reach_metric_states থাকে, যা মেট্রিকটি সাপ্রেস করা হয়েছে নাকি সম্পূর্ণ হয়েছে তা বর্ণনা করে।

যখনই কোনও রিচ মেট্রিক সাপ্রেস করা হয় বা রিটেনশন উইন্ডোর বাইরে থাকে (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION, অথবা DATE_RANGE_BEYOND_RETENTION), Metrics-এ এটির optional int64 ফিল্ড আনসেট করা হয় (ফিল্ডের উপস্থিতি চেক করা না হলে যা 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) হল filterable: false ও sortable: false সহ MESSAGE মেট্রিক, তাই সেগুলি WHERE বা ORDER BY ক্লজে ব্যবহার করা যাবে না। এছাড়াও, সারি জুড়ে রিচ মেট্রিক এগ্রিগেট করা যাবে না। metrics.unique_users মেট্রিক শুধুমাত্র ৯২ দিন বা তার কম সময়ের জন্য অনুরোধ করা যেতে পারে, যেখানে unique_users_*_plus ফ্রিকোয়েন্সি বাকেট মেট্রিক শুধুমাত্র ৩১ দিন বা তার কম সময়ের জন্য অনুরোধ করা যেতে পারে। ভিডিওর রিচ ও ফ্রিকোয়েন্সি মেট্রিকের সম্পূর্ণ তালিকা দেখতে, ক্যাম্পেন রিচ ও ফ্রিকোয়েন্সি রিপোর্টিং দেখুন।