Performance reports

توفر Merchant API تقارير الأداء، مثل product_performance_view. توضّح هذه الصفحة بنية تقارير الأداء.

المقاييس

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

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

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

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

يعرض نموذج الردّ التالي أنّ التاجر حصل على إجمالي 4,440 نقرة على مستوى كل المنتجات وجميع طرق التسويق بين 1 ديسمبر 2023 و21 ديسمبر 2023.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4440"
      }
    }
  ]
}

الشرائح

يمكنك استخدام حقول الشرائح لتقسيم البيانات في تقارير الأداء. على سبيل المثال، يؤدي طلب marketing_method إلى عرض تقرير يتضمّن صفًا لكل طريقة تسويق، والمقاييس التي تحدّدها لطريقة التسويق هذه في عبارة SELECT.

يمكن أن تكون حقول الشرائح سمات منتج (مثل offer_id وbrand وcategory) أو سمات حدث (مثل date وmarketing_method).

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

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

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

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

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

كما هو الحال مع التقارير المخصّصة في Merchant Center، يمكنك تحديد شرائح متعدّدة في الاستعلام نفسه باستخدام Merchant Reports API.

في ما يلي نموذج استعلام يعرض النقرات لجميع المنتجات في حسابك خلال فترة مدتها 30 يومًا، مقسّمة حسب marketing_method وoffer_id:

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

يتضمّن الردّ على هذا الاستعلام صفًا لكل مجموعة من offer_id وmarketing_method، مع عدد النقرات لهذه المجموعة:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

الفئة ونوع المنتج

تتيح لغة طلبات البحث في Merchant Center تقسيم المقاييس حسب مجموعتَين من السمات يمكنك تحديدهما لتنظيم مستودعك:

مستويات الفئات
الفئات من تصنيف المنتجات من Google. قد تختار Google الفئة تلقائيًا لمنتجك إذا لم يتم تقديم أي فئة، أو قد تحسّن الفئة المقدَّمة.
مستويات نوع المنتج
أنواع المنتجات التي تحدّدها استنادًا إلى تصنيفك. على عكس مستويات الفئات، لا تتوفّر مجموعة محدّدة مسبقًا من القيم المسموح بها.

يتم تنظيم سمات الفئة ونوع المنتج في بنية هرمية تتضمّن مستويات متعدّدة. يفصل مواصفات المنتج بين كل مستوى باستخدام الرمز >، ولكن يمكنك اختيار كل مستوى من البنية الهرمية بشكل منفصل في التقارير.

على سبيل المثال، لنفترض أنّ منتجًا يتضمّن مستويات نوع المنتج التالية:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

تعرض التقارير كل مستوى في حقل منفصل:

تقسيم القيمة
product_type_l1 Home & Garden
product_type_l2 Kitchen & Dining
product_type_l3 Kitchen Appliances
product_type_l4 Refrigerators

مقاييس العملة والسعر

يتم تمثيل مقاييس السعر، مثل conversion_value، باستخدام النوع Price. إذا كان المقياس متاحًا بعدة عملات، يتم عرض قيمة كل عملة في صف منفصل. على سبيل المثال، يعرض الاستعلام التالي:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

النتائج التالية:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

إذا طلبت مقاييس السعر والمقاييس غير المرتبطة بالسعر في استعلام، يتم عرض مقاييس السعر في صفوف نتائج منفصلة عن المقاييس غير المرتبطة بالسعر، مع صف نتيجة واحد لكل رمز عملة. على سبيل المثال، يعرض الاستعلام التالي:

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

الردّ التالي:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

يتم عرض جميع الحقول التي تختارها في الردّ، حتى إذا كانت قيمتها لا تزال القيمة التلقائية أو صفرًا.

لمزيد من المعلومات عن الحقول المتاحة للاستعلام، يُرجى الاطّلاع على حقول جدول productPerformanceView.