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"
        }
      }
    }
  ]
}

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