پارامتر رشته پُرسمان filters داده‌های برگردانده‌شده در گزارش AdSense Management API را محدود می‌کند. وقتی از پارامتر filters استفاده می‌کنید،
بُعدی را که می‌خواهید فیلتر شود ارائه می‌دهید و سپس عبارت فیلتر را وارد می‌کنید.
پُرسمان‌های فیلترشده ردیف‌هایی را که در نتیجه گنجانده می‌شوند محدود می‌کنند. هر ردیف در نتیجه با فیلتر آزمایش می‌شود: اگر فیلتر مطابقت داشته باشد، ردیف حفظ می‌شود و اگر مطابقت نداشته باشد، ردیف حذف می‌شود.
- کدبندی نشانی وب: کتابخانه‌های کارخواه به‌طور خودکار عملگرهای فیلتر را کدبندی می‌کنند. بااین‌حال، اگر درخواست‌ها را مستقیماً به پروتکل ارسال می‌کنید، باید عملگرهای فیلتر را به‌طور صریح همان‌طور که در جدول زیر نشان داده شده است کدگذاری کنید.
- اولویت فیلتر کردن: فیلتر کردن قبل‌از تجمیع ابعاد انجام می‌شود، بنابراین سنجه‌های برگردانده‌شده نشان‌دهنده مجموع فقط ابعاد مربوطه است.
نحو فیلتر
یک فیلتر از این فرم استفاده می‌کند:
name operator expression
در این نحو:
- name — نام بُعدی که باید فیلتر شود.
برای مثال:
AD_CLIENT_IDبراساس شناسه مشتری آگهی فیلتر می‌کند. - operator — نوع مطابقت فیلتر را برای استفاده تعریف می‌کند.
- عبارت — مقادیر موجود در نتایج را بیان می‌کند.
همه بُعدهایی که
برای سنجه‌های گزارش‌شده اعمال می‌شوند می‌توانند به‌عنوان فیلتر استفاده شوند، به‌جز
بُعدهای مربوط به تاریخ (DATE، WEEK،
و MONTH). برای فیلتر کردن براساس تاریخ، به‌جای آن محدوده
تاریخ را برای گزارش مشخص کنید.
اپراتورهای فیلتر
دو اپراتور فیلتر وجود دارد. عملگرها باید کدبندی نشانی وب داشته باشند تا در رشته‌های پُرسمان نشانی وب گنجانده شوند.
| اپراتور | شرح | فرم کدبندی‌شده نشانی وب | مثال |
|---|---|---|---|
== |
تطابق کامل | %3D%3D |
سنجه‌های انبوهشی که نام کشور کانادا است:
filters=COUNTRY_NAME%3D%3DCanada |
=@ |
حاوی رشته فرعی است | %3D@ |
سنجه‌های انبوهشی که نام کشور حاوی United است، این
با United States و United Kingdom مطابقت دارد، برای مثال:
filters=COUNTRY_NAME%3D@United |
عبارت‌های فیلتر
چند قانون مهم برای عبارت‌های فیلتر وجود دارد:
- نویسه‌های رزروشده نشانی وب — نویسه‌هایی مثل
&باید به روش معمول کدبندی نشانی وب شوند. کتابخانه‌های کارخواه این کار را برای شما انجام می‌دهند، بنابراین فقط درصورتی باید نگران این کدگذاری باشید که تماس‌های مستقیم با پروتکل برقرار می‌کنید. - نویسه‌های رزروشده — ویرگول و واکج‌خط باید
هنگام ظاهر شدن در عبارت، با واکج‌خط گریز داده شوند.
- واکج‌خط
\\ - ویرگول
\,
- واکج‌خط
توجه: مطمئن شوید که واکج‌خط‌ها را قبل‌از ویرگول‌ها گریز می‌دهید تا از گریز مضاعف جلوگیری شود.
ترکیب کردن فیلترها
فیلترها را می‌توان بااستفاده از منطق بولی OR و AND ترکیب کرد.
منطق OR
منطق OR بااستفاده از ویرگول (,) در عبارت فیلتر تعریف می‌شود.
مثال: (هرکدام باید کدبندی نشانی وب داشته باشد)
کد کشور (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 ترکیب شوند.
مثال:
کد کشور (US یا UK) است و کد محصول AFC:
است
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC