التقسيم

التقسيم إلى شرائح متاحة في 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 استخدام فئتَين من المقاييس لميزة "الشراء على". طلبات 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

التعرف على المزيد

للحصول على قائمة كاملة بالشرائح، راجع المستندات.