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

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. توفّر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات وعمليات إعداد التقارير. اطّلِع على المزيد من المعلومات عن نقل البيانات إلى واجهة Search Ads 360 Reporting 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 السلسلة الفرعية "ham"، ولكن يتم تقييم جميع الأحرف، بما في ذلك المسافات، باستخدام الفلتر) صالح فقط لـ String عمود.	متغير
doesNotContainSubstring	يجب ألا يحتوي العمود على أي من السلاسل في قائمة الفلتر. على سبيل المثال، إذا كان الفلتر doesNotContainSubstring يحتوي على القيم التالية: ["ham", "cheese"] سيعرض الصفوف التي تتضمّن القيمة التالية: lobster roll lettuce ولكن لن يؤدي إلى عرض الصفوف التي تحتوي على القيم التالية: hamburger جبنبرغر صالح فقط لـ String عمود.	متغير
containsElement	يجب أن يحتوي العمود على قيمة واحدة على الأقل من القيم في قائمة الفلتر. صالح فقط للأعمدة التي تحتوي على أنواع بيانات القوائم (مثل String list). على سبيل المثال، في تقرير campaign، سيؤدي فلتر containsElement الذي يتضمّن القيم التالية: ["foo", "bar"] عند الفلترة حسب العمود effectiveLabels إلى عرض الحملات التي تحمل التصنيف foo أو bar أو كليهما فقط.	متغير