التقسيم

يمكن تنفيذ ميزة "التقسيم"، المتوفّرة في التقارير المخصّصة في 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

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

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

السابق
الاطّلاع على مؤشرات التسوّق
التالي
ترقيم الصفحات