يمكنك استخدام Merchant Reports API لعرض بيانات الأداء وفلترة منتجاتك حسب سمات محدّدة وتحسين الأسعار.
قياس الأداء
يمكنك استخدام Merchant Reports API ProductPerformanceView
لاسترداد مقاييس الأداء الخاصة بحسابك.
المتطلّبات
يجب أن يكون لديك دور الأداء والإحصاءات لاسترداد هذا التقرير.
لمنح أحد الحسابات دور "الأداء والإحصاءات"، استخدِم طريقة Content API
accounts.update
في Shopping لضبط الحقل reportsManager
على true
.
يحل accounts.update
محل مورد Account
بالكامل. استخدِم accounts.get
للحصول على مورد Account
الكامل، ثم أدخِل جميع الحقول في طلب accounts.update
كي لا تفقد المعلومات.
نموذج طلب بحث
يسترجع طلب البحث التالي impressions
وclicks
وclickThroughRate
لكل المنتجات في حسابك خلال فترة محددة مدتها 30 يومًا. لتقديم الطلب، مرِّر عبارة لغة طلب البحث في Merchant Center التالية إلى الطريقة
accounts.reports.search
:
SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
يمكنك أيضًا تقسيم المقاييس في طلب البحث للحصول على تقارير أداء أكثر دقة.
فلترة المنتجات
يمكنك استخدام واجهة برمجة التطبيقات
ProductView
في Merchant Reports API للاطّلاع على عرض مفلتر لبيانات المنتجات، بما في ذلك حالات المنتجات. على سبيل المثال، يمكنك إجراء طلب بحث عن ProductView
لعرض بيانات المنتجات التي فيها مشاكل أو للحصول على قائمة بمنتجاتك الجديدة والتحقّق من صحة عرض الإعلانات.
يجب تضمين الحقل id
في عبارة SELECT
من طلب البحث. يتضمّن السمة id
القيمة نفسها لمعرّف RST للمنتج.
يمكنك الفلترة بناءً على جميع الحقول
المتاحة،
باستثناء itemIssues
. يمكنك ترتيب الرد استنادًا إلى جميع الحقول المتاحة
باستثناء ما يلي:
gtin
itemIssues
في ما يلي مثال على إرجاع منتجاتك بالحالة NOT_ELIGIBLE_OR_DISAPPROVED
. لتقديم الطلب، مرِّر عبارة لغة طلب البحث في Merchant Center التالية إلى الطريقة
accounts.reports.search
:
SELECT
id,
offerId,
feedLabel,
title,
aggregatedReportingContextStatus
itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'
إليك نموذج رد من الاستعلام السابق:
{
"results": [
{
"productView": {
"id": "online~en~US~id0"
"offerId": "id0",
"feedLabel": "US",
"aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
"itemIssues": [
{
"type": {
"code": "invalid_string_value",
"canonicalAttribute": "n:product_code"
},
"severity": {
"severityPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
},
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"aggregatedSeverity": "DISAPPROVED"
},
"resolution": "MERCHANT_ACTION"
},
{
"type": {
"code": "apparel_missing_brand",
"canonicalAttribute": "n:brand"
},
"severity": {
"severityPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
}
],
"aggregatedSeverity": "DEMOTED"
},
"resolution": "MERCHANT_ACTION"
}
]
}
}
]
}
يمكنك الاطّلاع على مرجع
ProductView
للحصول على مزيد من المعلومات حول مجالات وسلوكيات محدّدة.
تحسين الأسعار
يمكنك استخدام العرض "معلومات مفصّلة عن الأسعار" للاطّلاع على الأسعار المخفَّضة المقترَحة لمنتجاتك، والاطّلاع على توقّعات حول الأداء الذي يُحتمل أن تحقّقه إذا عدّلت أسعار منتجاتك. ويمكن أن يساعدك استخدام هذا التقرير على تسعير منتجاتك بفعالية أكبر
يمكنك الاطّلاع على تحسين أسعار المنتجات باستخدام تقرير "معلومات مفصّلة عن الأسعار" للحصول على مزيد من المعلومات.
طلب البحث
PriceInsightsProductView
للاطّلاع على الأسعار المخفَّضة المقترَحة لمنتجاتك
في ما يلي نموذج يمكنك استخدامه لعرض الأسعار المخفَّضة المقترَحة لمنتجاتك. لتقديم الطلب، مرِّر عبارة لغة طلب البحث في Merchant Center التالية إلى طريقة
accounts.reports.search
:
SELECT
id,
title,
brand,
price,
suggested_price,
predictedImpressionsChangeFraction,
predictedClicksChangeFraction,
predictedConversionChangeFraction
FROM PriceInsightsProductView
إليك نموذج رد من الاستعلام السابق:
{
"results": [
{
"priceInsightsProductView": {
"id": "online~en~US~12345",
"title": "UGG Women's s Classic Mini",
"brand": "UGG",
"price" {
"amountMicros": "124990000",
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "135680000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.12609300017356873",
"predictedClicksChangeFraction": "0.508745014667511",
"predictedConversionsChangeFraction": "2.3431060314178467"
}
},
{
"priceInsightsProductView": {
"id": "online~en~US~12346",
"title": "Nike React Infinity Run Flyknit 2",
"brand": "Nike",
"price" {
"amountMicros": "119990000"
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "125440000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.1799899935722351",
"predictedClicksChangeFraction": "0.6203680038452148",
"predictedConversionsChangeFraction": "1.234868049621582"
}
},
{
"priceInsightsProductView": {
"id": "online~en~US~12347",
"title": " New Balance 327 White Trainers",
"brand": "New Balance",
"price" {
"amountMicros": "84990000"
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "82000000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.11538799852132797",
"predictedClicksChangeFraction": "0.5869849920272827",
"predictedConversionsChangeFraction": "1.3622850179672241"
}
}
]
}