تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

التقسيم

إنّ ميزة التصنيف إلى شرائح المتوفّرة في التقارير المخصّصة ضمن 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'

تشغيل

انقر على Run (تشغيل) لتجربة النموذج في API Explorer (مستكشف واجهات برمجة التطبيقات). بعد النقر على تشغيل، عدِّل العنصر النائب لمعرّف التاجر إلى معرّف التاجر الخاص بك في عنوان 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.order_item_sales_micros. وبما أنّ هذا الإجراء مهم لتفسير هذه المقاييس بشكل صحيح، ستتضمّن السمة ReportRow التي يتم إرجاعها القيمة segments.currency_code تلقائيًا كلما اخترت أحد مقاييس الأسعار أدناه.

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

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

للحصول على قائمة كاملة بالشرائح، يمكنك مراجعة الوثائق.

الاطّلاع على مؤشرات التسوّق

ترقيم الصفحات