التقسيم

يمكن تنفيذ التصنيف إلى شرائح، متوفّر في التقارير المخصّصة في 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.product_type_l1	Home & Garden
segments.product_type_l2	Kitchen & Dining
segments.product_type_l3	Kitchen Appliances
segments.product_type_l4	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

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

للحصول على قائمة كاملة بالأقسام، يمكنك الاطّلاع على المستندات.