تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الفلترة

تحظر معلَمة سلسلة طلب البحث "filters" البيانات التي يتم عرضها. في تقرير واجهة برمجة تطبيقات AdSense Management عند استخدام مَعلمة filters، يجب أضِف بُعدًا تريد الفلترة وفقًا له، متبوعًا بتعبير الفلتر.

تؤدي طلبات البحث التي تمت فلترتها إلى تقييد الصفوف التي يتم تضمينها في النتيجة. يحتوي كل صف في النتيجة مقابل الفلتر: إذا تطابق الفلتر، يتم الاحتفاظ بها وعدم تطابقها، سيتم إسقاط الصف.

ترميز عنوان URL: يتم ترميز مكتبات البرامج تلقائيًا. عوامل التصفية. مع ذلك، إذا قدمت طلبات إلى البروتوكول مباشرةً، يجب ترميز عوامل التصفية بشكل صريح كما هو موضّح في الجدول أدناه.
أولوية الفلترة: تحدث الفلترة قبل أي وقت تجميعًا للأبعاد، بحيث تمثل المقاييس المعروضة إجمالي للأبعاد الملائمة فقط.

بنية الفلتر

يستخدم فلتر واحد النموذج التالي:

name operator expression

في بناء الجملة هذا:

name - اسم السمة التي تريد إجراء الفلترة عليها. على سبيل المثال: ستتم الفلترة حسب رقم تعريف العميل الإعلاني من النوع AD_CLIENT_ID.
عامل التشغيل — يحدد نوع مطابقة الفلتر المطلوب استخدامه.
expression — يوضح القيم المضمنة في النتائج.

جميع السمات التي تنطبق على المقاييس التي يتم إعداد تقارير عنها ويمكن استخدامها كفلاتر، مع باستثناء السمات ذات الصلة بالتاريخ (DATE وWEEK وMONTH). للتصفية حسب التاريخ، حدد النطاق الزمني للتقرير بدلاً من ذلك

عوامل تشغيل الفلاتر

هناك عاملان للتصفية. يجب أن تكون عوامل التشغيل بترميز عنوان URL من أجل تضمينها في سلاسل طلب بحث عنوان URL.

مُشغِّل	الوصف	نموذج عنوان URL المرمّز	مثال
`==`	مطابقة تامة	`%3D%3D`	المقاييس المجمّعة حيث يكون اسم البلد هو كندا: `filters=COUNTRY_NAME%3D%3DCanada`
`=@`	يحتوي على سلسلة فرعية	`%3D@`	مقاييس مجمّعة يحتوي فيها اسم البلد على كلمة مصر يتطابق مع الولايات المتحدة والمملكة المتحدة على سبيل المثال: `filters=COUNTRY_NAME%3D@United`

تصفية التعبيرات

هناك قاعدتان مهمتان لتعبيرات الفلاتر:

الأحرف المحجوزة لعنوان URL: الأحرف مثل يجب أن يكون & بترميز عنوان URL بالطريقة المعتادة. مكتبات العملاء عليك الاهتمام بنفسك، لذا لا تقلق بشأن هذا الترميز إلا إذا أنك تجري اتصالات مباشرة للبروتوكول.
الأحرف المحجوزة - يجب استخدام الفاصلة والشرطة المائلة للخلف يتم تخطيها بشرطة مائلة للخلف عند ظهورها في تعبير.
- شرطة مائلة للخلف \\
- فاصلة \,

ملاحظة: تأكد من تجنب الشرطة المائلة للخلف قبل والفاصلات، وذلك لتجنب الاستغراق المزدوج.

دمج الفلاتر

يمكن دمج الفلاتر باستخدام القيم المنطقية OR وAND. المنطق.

منطق OR

يتم تحديد منطق OR باستخدام فاصلة (,) داخل تعبير عامل التصفية.

مثال: (يجب أن يكون كلّ منها عنوان URL مرمّزًا)

رمز البلد هو إما (الولايات المتحدة أو المملكة المتحدة):
COUNTRY_CODE==US,COUNTRY_CODE==UK

منطق AND

يمكن تحقيق منطق AND من خلال توفير معلَمات فلاتر متعددة، وهو ما يُترجم إلى توفير مجموعة من الفلاتر في مكتبات العملاء.

مثال:

رمز البلد هو الولايات المتحدة ورمز المنتج هو AFC:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC

الجمع بين منطق AND وOR

من الممكن الجمع بين منطق AND وOR في تعبير واحد.

ملاحظة: يتم تقييم كل فلتر على حدة. قبل دمج كل عوامل التصفية في تعبير منطقي "و".