التقسيم

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

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

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