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": "4,440"
      }
    }
  ]
}

الشرائح

يمكنك استخدام حقول الشرائح للتقسيم في تقارير الأداء. على سبيل المثال، يؤدي طلب البحث عن 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.