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