التقسيم

يمكن تنفيذ التقسيم، المتاح في التقارير المخصّصة في Merchant Center، في Reporting API من خلال إضافة الحقل المناسب إلى طلب بحث. على سبيل المثال، يؤدي طلب البحث عن segments.program إلى إنشاء تقرير يتضمّن صفًا لكل برنامج (إعلانات Shopping، وبيانات المنتجات المجانية، وما إلى ذلك) يتضمّن المقاييس (مرات الظهور، والنقرات، وما إلى ذلك) الخاصة بهذا البرنامج كما هو محدّد في عبارة SELECT.

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

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

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

تشغيل

انقر على تنفيذ لتجربة العيّنة في مستكشف واجهات برمجة التطبيقات. بعد النقر على تنفيذ، عدِّل عنصر نائب معرّف التاجر إلى معرّف التاجر الخاص بك في عنوان URL للطلب. يمكنك تعديل طلب البحث. يجب أن يبقى الاستعلام الكامل على سطر واحد لكي يعمل مع مستكشف واجهة برمجة التطبيقات.

النتائج التي يتم الحصول عليها من إرسال طلب البحث هذا إلى reports.search هي صف يحدّد عدد النقرات لكل مجموعة من offer_id وprogram، كما هو موضّح في نموذج سلسلة JSON التالي:

{
  "results": [
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "38"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "125"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "23"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "8"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "3"
      }
    }
  ]
}

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

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

مستويات الفئات (segments.category_l1 وsegments.category_l2 وما إلى ذلك)

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

مستويات نوع المنتج (segments.product_type_l1 وsegments.product_type_l2 وما إلى ذلك)

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

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

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

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

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

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

يشير الحقل segments.currency_code في ReportRow إلى العملة التي يتم عرض مقاييس الأسعار بها، مثل metrics.conversion_value_micros. بما أنّ هذا الإجراء مهم من أجل تفسير هذه المقاييس بشكل صحيح، سيشمل الرمز ReportRow الذي يتم عرضه تلقائيًا الرمز segments.currency_code كلّما اخترت أحد مقاييس الأسعار أدناه.

• metrics.conversion_value_micros

• metrics.aov_micros
• metrics.ordered_item_sales_micros
• metrics.returns_micros
• metrics.shipped_item_sales_micros

مقاييس "الشراء على Google"

تتيح Merchant Center Query Language فئتَين من المقاييس لطلبات "الشراء على Google": مقاييس على مستوى السلعة ومقاييس على مستوى الطلب.

المقاييس على مستوى المنتج أو الخدمة

مقاييس يتم احتسابها استنادًا إلى السلع ضمن الطلبات، ومرتبطة بسمات المنتجات في كل طلب

• metrics.item_days_to_ship
• metrics.item_fill_rate
• metrics.ordered_items
• metrics.ordered_item_sales_micros
• metrics.rejected_items
• metrics.returned_items
• metrics.return_rate
• metrics.returns_micros
• metrics.shipped_items
• metrics.shipped_item_sales_micros
• metrics.unshipped_items

المقاييس على مستوى الطلب

مقاييس يتم احتسابها على أساس كل طلب.

• metrics.aos
• metrics.aov_micros
• metrics.days_to_ship
• metrics.orders
• metrics.shipped_orders
• metrics.unshipped_orders

لا ترتبط المقاييس على مستوى الطلب بسمات المنتجات في كل طلب.

يمكنك اختيار مقاييس على مستوى المنتج أو الخدمة مع أي شريحة متاحة. ومع ذلك، سيؤدي اختيار مقاييس على مستوى الطلب مع أيّ من شرائح سمات المنتج التالية إلى حدوث خطأ:

• segments.brand
• segments.category_l1، وsegments.category_l2، وsegments.category_l3، وsegments.category_l4، وsegments.category_l5
• segments.custom_label1، وsegments.custom_label2، وsegments.custom_label3، وsegments.custom_label4، وsegments.custom_label5
• segments.offer_id
• segments.product_type_l1، وsegments.product_type_l2، وsegments.product_type_l3، وsegments.product_type_l4، وsegments.product_type_l5
• segments.title

تعرَّف على مزيد من المعلومات

للاطّلاع على القائمة الكاملة للشرائح، يمكنك مراجعة المستندات.