filters ক্যোয়ারী স্ট্রিং প্যারামিটার অ্যাডসেন্স ম্যানেজমেন্ট এপিআই রিপোর্টে ফিরে আসা ডেটা সীমাবদ্ধ করে। যখন আপনি filters প্যারামিটার ব্যবহার করেন, তখন আপনি ফিল্টার করতে চান এমন একটি মাত্রা সরবরাহ করেন, তারপরে ফিল্টার এক্সপ্রেশন।
ফিল্টার করা প্রশ্নগুলি ফলাফলে অন্তর্ভুক্ত হওয়া সারিগুলিকে সীমাবদ্ধ করে। ফলাফলের প্রতিটি সারি ফিল্টারের বিরুদ্ধে পরীক্ষা করা হয়: ফিল্টারটি মেলে, সারিটি ধরে রাখা হয় এবং যদি এটি মেলে না, সারিটি বাদ দেওয়া হয়।
- URL এনকোডিং : ক্লায়েন্ট লাইব্রেরি স্বয়ংক্রিয়ভাবে ফিল্টার অপারেটর এনকোড করে। যাইহোক, আপনি যদি সরাসরি প্রোটোকলের কাছে অনুরোধ করেন, তাহলে আপনাকে অবশ্যই স্পষ্টভাবে ফিল্টার অপারেটরগুলিকে এনকোড করতে হবে যেমনটি নীচের সারণীতে নির্দেশ করা হয়েছে৷
- ফিল্টারিং অগ্রাধিকার : কোনো মাত্রা একত্রিত হওয়ার আগে ফিল্টারিং ঘটে, যাতে প্রত্যাবর্তিত মেট্রিক্স শুধুমাত্র প্রাসঙ্গিক মাত্রার জন্য মোটের প্রতিনিধিত্ব করে।
ফিল্টার সিনট্যাক্স
একটি একক ফিল্টার ফর্ম ব্যবহার করে:
name operator expression
এই সিনট্যাক্সে:
- নাম — ফিল্টার করা মাত্রার নাম। যেমন:
AD_CLIENT_IDবিজ্ঞাপন ক্লায়েন্ট আইডিতে ফিল্টার করবে। - অপারেটর - ব্যবহার করার জন্য ফিল্টার মিলের ধরন সংজ্ঞায়িত করে।
- অভিব্যক্তি - ফলাফলে অন্তর্ভুক্ত মানগুলিকে বলে।
তারিখ-সম্পর্কিত মাত্রাগুলি ( DATE , WEEK , এবং MONTH ) ব্যতীত, রিপোর্ট করা মেট্রিকগুলিতে প্রযোজ্য সমস্ত মাত্রাগুলি ফিল্টার হিসাবে ব্যবহার করা যেতে পারে। তারিখ অনুসারে ফিল্টার করতে, রিপোর্টের জন্য তারিখ পরিসীমা উল্লেখ করুন ।
ফিল্টার অপারেটর
দুটি ফিল্টার অপারেটর আছে। URL ক্যোয়ারী স্ট্রিংগুলিতে অন্তর্ভুক্ত করার জন্য অপারেটরগুলিকে অবশ্যই URL এনকোডেড হতে হবে৷
| অপারেটর | বর্ণনা | URL এনকোড করা ফর্ম | উদাহরণ |
|---|---|---|---|
== | হুবহু মিল | %3D%3D | সমষ্টিগত মেট্রিক্স যেখানে দেশের নাম কানাডা :filters=COUNTRY_NAME%3D%3DCanada |
=@ | সাবস্ট্রিং ধারণ করে | %3D@ | সমষ্টিগত মেট্রিক্স যেখানে দেশের নামটিতে United রয়েছে, এটি মার্কিন যুক্তরাষ্ট্র এবং যুক্তরাজ্যের সাথে মেলে উদাহরণস্বরূপ:filters=COUNTRY_NAME%3D@United |
এক্সপ্রেশন ফিল্টার করুন
ফিল্টার এক্সপ্রেশনের জন্য কয়েকটি গুরুত্বপূর্ণ নিয়ম রয়েছে:
- ইউআরএল-সংরক্ষিত অক্ষর — অক্ষর যেমন
&অবশ্যই স্বাভাবিক উপায়ে ইউআরএল-এনকোড করা উচিত। ক্লায়েন্ট লাইব্রেরিগুলি আপনার জন্য এটির যত্ন নেয়, তাই আপনি যদি প্রোটোকলটিতে সরাসরি কল করেন তবেই আপনাকে এই এনকোডিং সম্পর্কে চিন্তা করতে হবে৷ - সংরক্ষিত অক্ষর — কমা এবং ব্যাকস্ল্যাশ অবশ্যই ব্যাকস্ল্যাশ এস্কেপড হতে হবে যখন তারা একটি অভিব্যক্তিতে উপস্থিত হয়।
- ব্যাকস্ল্যাশ
\\ - কমা
\,
- ব্যাকস্ল্যাশ
দ্রষ্টব্য: নিশ্চিত করুন যে আপনি কমার আগে ব্যাকস্ল্যাশ এড়িয়ে গেছেন, যাতে ডবল এস্কেপিং এড়ানো যায়।
ফিল্টার সমন্বয়
OR এবং AND বুলিয়ান লজিক ব্যবহার করে ফিল্টারগুলিকে একত্রিত করা যেতে পারে।
বা যুক্তি
OR যুক্তি ফিল্টার এক্সপ্রেশনের ভিতরে একটি কমা ( , ) ব্যবহার করে সংজ্ঞায়িত করা হয়।
উদাহরণ: (প্রতিটি URL এনকোড করা আবশ্যক)
দেশের কোড হয় (মার্কিন বা যুক্তরাজ্য):
COUNTRY_CODE==US,COUNTRY_CODE==UK
এবং যুক্তি
AND যুক্তি একাধিক ফিল্টার পরামিতি প্রদান করে অর্জন করা হয়, যা ক্লায়েন্ট লাইব্রেরিতে ফিল্টারগুলির একটি অ্যারে প্রদানে অনুবাদ করে।
উদাহরণ:
দেশের কোড হল US এবং পণ্য কোড হল AFC:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC
AND এবং OR যুক্তির সমন্বয়
একটি একক অভিব্যক্তিতে AND এবং OR যুক্তিকে একত্রিত করা সম্ভব।
দ্রষ্টব্য: সমস্ত ফিল্টার একটি AND যৌক্তিক অভিব্যক্তিতে একত্রিত হওয়ার আগে প্রতিটি ফিল্টার পৃথকভাবে মূল্যায়ন করা হয়।
উদাহরণ:
দেশের কোড হল (মার্কিন বা যুক্তরাজ্য) এবং পণ্য কোড হল AFC:
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC