التقسيم

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

مزيد من المعلومات

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