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