Performance reports

توفّر Merchant API تقارير الأداء، على سبيل المثال ProductPerformanceView. تشرح هذه الصفحة بنية تقارير الأداء.

المقاييس

يمكنك طلب البحث عن المقاييس التي تريدها (مثل clicks وimpressions). يجب إضافة فلتر إلى النطاق الزمني لطلب البحث في خدمة "التقارير" عن بيانات الأداء.

إليك نموذج طلب بحث يعرض صفًا واحدًا مع إجمالي عدد النقرات ضمن النطاق الزمني المحدّد:

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

يجب تحديد البيانات التي تريد عرضها. تعرِض أحرف البدل (على سبيل المثال، SELECT *) خطأ.

يُظهر نموذج الإجابة التالي أنّ التاجر قد حصل على 4,440 نقرة إجمالاً على كل المنتجات وبجميع طرق التسويق، وذلك في الفترة بين 1 كانون الأول (ديسمبر) 2020 و21 كانون الأول (ديسمبر) 2020.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

الشرائح

يمكنك استخدام MCQL للاستعلام عن حقول الشرائح. يمكن أن تكون حقول الشرائح سمات منتج (على سبيل المثال، offerId وbrand وcategory) أو سمات الأحداث (مثل date وmarketingMethod).

تعمل حقول الشرائح بشكل مشابه لـ GROUP BY في SQL. تُقسِّم حقول "الشرائح" المقاييس المحددة، ويتم تجميعها حسب كل شريحة في عبارة SELECT.

في ما يلي نموذج طلب بحث يعرض النقرات في اليوم، بترتيب تنازلي حسب clicks، ضمن الشرط المُضاف لنطاق زمني. لا يتم عرض سوى الصفوف التي يكون فيها مقياس واحد على الأقل غير صفري.

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

يُظهر نموذج الردّ التالي أنّ التاجر حصل على 1,546 نقرة على جميع المنتجات وبجميع طرق التسويق في 1 كانون الأول (ديسمبر) 2020 و829 نقرة على كل المنتجات على جميع طرق التسويق في 2 كانون الأول (ديسمبر) 2020. لم يتلقَّ التاجر أيّ نقرات في 3 كانون الأول (ديسمبر) 2020، لذا لا يتمّ عرض أيّ منتج لذلك التاريخ.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}