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