التقارير التي تمت تصفيتها

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن توفر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات إعداد التقارير والعمليات. مزيد من المعلومات عن نقل البيانات إلى التجربة الجديدة من "إعلانات شبكة البحث 360" واستخدامها API.

سيحتوي تقريرك تلقائيًا على جميع البيانات ضمن 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	يجب أن يتطابق العمود تمامًا مع إحدى القيم في قائمة الفلتر. غير صالح لأنواع بيانات القائمة (مثل String list).	متغير
lessThan	يجب أن يحتوي العمود على قيمة أقل من القيمة المحدّدة. في حال تحديد هذا الفلتر لعمود "Boolean"، ستحوّل Search Ads 360 API القيمة "false". إلى قيمة عددية من 0 ومن true إلى 1. في حال حذف تحدّده لعمود String، تقارن واجهة برمجة التطبيقات الترتيب المعجم. غير صالح لأنواع بيانات القائمة (مثل String list).	1
greaterThan	يجب أن يحتوي العمود على قيمة أكبر من إحدى القيم في قائمة عامل التصفية. إذا حدّدت هذا الفلتر لعمود "Boolean"، ستحوِّل واجهة برمجة التطبيقات false. إلى قيمة عددية من 0 ومن true إلى 1. في حال حذف تحدّده لعمود String، تقارن واجهة برمجة التطبيقات الترتيب المعجم. غير صالح لأنواع بيانات القائمة (مثل String list).	1
lessThanOrEqual	يجب أن يحتوي العمود على قيمة أقل من أو تساوي أحد القيم في قائمة الفلتر. إذا حدّدت هذا الفلتر لعمود "Boolean"، ستحوِّل واجهة برمجة التطبيقات false. إلى قيمة عددية من 0 ومن true إلى 1. في حال حذف تحدّده لعمود String، تقارن واجهة برمجة التطبيقات الترتيب المعجم. غير صالح لأنواع بيانات القائمة (مثل String list).	1
greaterThanOrEqual	يجب أن يحتوي العمود على قيمة أكبر من أو تساوي إحدى القيم في قائمة الفلتر. إذا حدّدت هذا الفلتر لعمود "Boolean"، ستحوِّل واجهة برمجة التطبيقات false. إلى قيمة عددية من 0 ومن true إلى 1. في حال حذف تحدّده لعمود String، تقارن واجهة برمجة التطبيقات الترتيب المعجم. غير صالح لأنواع بيانات القائمة (مثل String list).	1
isNull	يجب أن يكون العمود فارغًا. على سبيل المثال، إذا حددت isNull لعمود keywordMaxCpc في تقرير الكلمات الرئيسية، يحدد التقرير سوف يحتوي فقط على الكلمات الرئيسية التي لم تحدد التكلفة القصوى للنقرة.	0
isNotNull	يجب أن يحتوي العمود على قيمة.	0
startsWith	يجب أن يبدأ العمود بإحدى السلاسل في قائمة الفلتر. صالح فقط لـ String عمود.	متغير
containsSubstring	يجب أن يحتوي العمود على كل السلاسل أو جزء منها المحددة في قائمة عامل التصفية. على سبيل المثال، فلتر containsSubstring يتضمّن القيم التالية: ["ham", "cheese"] ستعرض صفوفًا بهذه القيمة: hamburger cheeseburger ولكن لن تعرض صفوفًا تحتوي على القيم التالية: lobster roll lettuce high amplitude (تشمل high amplitude السلسلة الفرعية "h am"، ولكن يتم تقييم جميع الأحرف، بما في ذلك المسافات، بواسطة الفلتر) صالح فقط لـ String عمود.	متغير
doesNotContainSubstring	يجب ألا يحتوي العمود على أي من السلاسل في قائمة الفلتر. على سبيل المثال، فلتر doesNotContainSubstring يتضمّن القيم التالية: ["ham", "cheese"] ستعرض صفوفًا بهذه القيمة: lobster roll lettuce ولكن لن تعرض صفوفًا تحتوي على القيم التالية: هامبرغر جبنبرغر صالح فقط لـ String عمود.	متغير
containsElement	يجب أن يحتوي العمود على قيمة واحدة على الأقل من القيم المدرَجة في قائمة الفلتر. صالح فقط للأعمدة التي تتضمن أنواع بيانات قائمة (مثل String list). على سبيل المثال، في تقرير campaign، فلتر containsElement بالقيم التالية: ["foo", "bar"] الفلترة حسب العمود effectiveLabels ستعرض فقط الحملات ذات التصنيف foo أو bar أو كليهما.	متغير