تقارير الأداء

توفّر 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.

السابق
Evaluate your products
التالي
Understand the market