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

الفلترة

تعمل معلَمة سلسلة طلب البحث filters على تقييد البيانات التي يتم عرضها في تقرير AdSense Management API. عند استخدام المَعلمة 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 باستخدام فاصلة (,) داخل تعبير الفلتر.

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

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

منطق AND

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

مثال:

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

الجمع بين عاملَي التشغيل المنطقيَين (و) و(أو)

يمكن دمج عاملَي التشغيل المنطقيَين (و) و(أو) في تعبير واحد.

ملاحظة: يتم تقييم كل فلتر بشكل فردي قبل دمج كل الفلاتر في تعبير منطقي AND.