سيتضمّن تقريرك تلقائيًا جميع البيانات ضمن reportScope التي يحدّدها طلبك. إذا أردت أن يتضمّن التقرير البيانات التي تتطابق مع مجموعة من المعايير فقط، يمكنك إضافة فلتر واحد أو أكثر إلى التقرير. يتم فقط عرض الصفوف التي تستوفي جميع الفلاتر.
على سبيل المثال، يمكنك طلب تقرير عن جميع الكلمات الرئيسية في إحدى الوكالات. وبعد ذلك، يمكنك تحديد فلتر بحيث لا تظهر في التقرير سوى الكلمات الرئيسية التي تبدأ بعناوين URL للصفحات المقصودة والتي تبدأ بـ www.example.com وwww.another-example.com.
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
يحدّد كل فلتر عمودًا ستتم فلترته وعامل تشغيل وقائمة بالقيم التي من المتوقّع أن تكون متوفرة في العمود المحدّد:
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
".
عوامل تشغيل الفلاتر
جميع الفلاتر حسّاسة لحالة الأحرف. ويعني ذلك أنّ الفلتر الذي يتضمّن "www.Sprockets.com" لن يتطابق مع عمود يحتوي على "www.sprockets.com".
المؤثِّر | الوصف | عدد القيم المسموح بها |
---|---|---|
equals |
يجب أن يتطابق العمود تمامًا مع القيمة المحددة. | 1 |
notEquals |
يجب ألا يتطابق العمود مع القيمة المحددة. | 1 |
in |
يجب أن يتطابق العمود تمامًا مع إحدى القيم في قائمة الفلتر.
غير صالح لأنواع بيانات القوائم (مثل |
متغير |
lessThan |
يجب أن يحتوي العمود على قيمة أقل من القيمة المحدّدة.
إذا حدّدت هذا الفلتر لعمود غير صالح لأنواع بيانات القوائم (مثل |
1 |
greaterThan |
يجب أن يحتوي العمود على قيمة أكبر من إحدى القيم المتوفّرة في قائمة الفلتر.
إذا حدّدت هذا الفلتر لعمود
غير صالح لأنواع بيانات القوائم (مثل |
1 |
lessThanOrEqual |
يجب أن يحتوي العمود على قيمة أقلّ من أو تساوي إحدى القيم المتوفّرة في قائمة الفلتر.
إذا حدّدت هذا الفلتر لعمود
غير صالح لأنواع بيانات القوائم (مثل |
1 |
greaterThanOrEqual |
يجب أن يحتوي العمود على قيمة أكبر من أو تساوي إحدى القيم المتوفّرة في قائمة الفلتر.
إذا حدّدت هذا الفلتر لعمود
غير صالح لأنواع بيانات القوائم (مثل |
1 |
isNull |
يجب أن يكون العمود فارغًا. على سبيل المثال، إذا حدّدت isNull
لعمود keywordMaxCpc في تقرير الكلمات الرئيسية،
سيحتوي التقرير فقط على الكلمات الرئيسية التي لم تحدّد تكلفة قصوى للنقرة.
|
0 |
isNotNull |
يجب أن يحتوي العمود على قيمة. | 0 |
startsWith |
يجب أن يبدأ العمود بإحدى السلاسل في قائمة الفلتر.
صالح فقط لـ |
متغير |
containsSubstring |
يجب أن يحتوي العمود على جميع السلاسل المحدّدة في قائمة الفلاتر أو جزء منها.
على سبيل المثال، إذا كان الفلتر
ولكن لن تعرض الصفوف التي تحتوي على القيم التالية:
صالح فقط لـ |
متغير |
doesNotContainSubstring |
يجب ألا يحتوي العمود على أي من السلاسل في قائمة الفلتر.
على سبيل المثال، إذا كان الفلتر ولكن لن يؤدي إلى عرض الصفوف التي تحتوي على القيم التالية:
صالح فقط لـ |
متغير |
containsElement |
يجب أن يحتوي العمود على قيمة واحدة على الأقل من القيم في قائمة الفلتر.
صالح فقط للأعمدة التي تحتوي على أنواع بيانات القوائم (مثل
على سبيل المثال، في تقرير |
متغير |