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 على جميع المنتجات وعلى جميع طرق التسويق في 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"
      }
    }
  ]
}