אתם יכולים להשתמש ב-Merchant Reports API כדי לראות נתוני ביצועים, לסנן את המוצרים לפי מאפיינים ספציפיים ולשפר את התמחור.
למדוד ביצועים
אתם יכולים לאחזר מדדי ביצועים של החשבון באמצעות Merchant Reports API product_performance_view.
דרישות
כדי לאחזר את הדוח הזה, צריך להיות לכם תפקיד עם גישה לביצועים ולתובנות.
כדי להקצות את התפקיד 'ביצועים ותובנות' למשתמש קיים, צריך ליצור בקשת תיקון ולהקצות למשתמש את זכות הגישה PERFORMANCE_REPORTING. בבקשה הבאה מוצג אופן יצירת בקשת תיקון להקצאת זכות הגישה PERFORMANCE_REPORTING:
PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}
{
"accessRights": [
"PERFORMANCE_REPORTING"
]
}
מחליפים את מה שכתוב בשדות הבאים:
- {ACCOUNT_ID}: המזהה הייחודי של חשבון Merchant Center.
- {EMAIL_ID}: כתובת האימייל של המשתמש שרוצים להקצות לו את התפקיד.
דוגמה לשאילתה
השאילתה הבאה מאחזרת את הערכים impressions, clicks ו-click_through_rate של כל המוצרים בחשבון שלכם במהלך תקופה ספציפית של 30 יום. כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה של Merchant Center Query Language אל השיטה accounts.reports.search:
SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
מידע נוסף על דוחות ביצועים זמין במדריך בנושא דוחות ביצועים.
סינון מוצרים
אתם יכולים להשתמש ב-Merchant Reports API
product_view
כדי להציג תצוגה מסוננת של נתוני המוצרים, כולל סטטוס המוצרים. לדוגמה, אפשר להשתמש בשאילתה product_view כדי לקבל רשימה של מוצרים שיש להם בעיות, או כדי לקבל רשימה של המוצרים החדשים שלכם ולאמת את ההצגה שלהם.
צריך לכלול את השדה id בפסוקית SELECT של השאילתה. השדה id מכיל את אותו ערך כמו מזהה REST של המוצר.
אפשר לסנן לפי כל השדות הזמינים, חוץ מהשדות הבאים:
status_per_reporting_contextitem_issues
אפשר למיין את התשובה לפי כל השדות הזמינים, חוץ מהשדות הבאים:
gtinstatus_per_reporting_contextitem_issues
כדי להבין את כשירות המוצר הכוללת, אפשר לבדוק את השדה aggregated_reporting_context_status. בשדה הזה מוצג סיכום של הסטטוסים בכל ההקשרים של דיווח על מוצר.
הנה דוגמה שמחזירה את המוצרים עם הסטטוס המצטבר ELIGIBLE_LIMITED, כלומר הם עומדים בדרישות להצגה לפחות בהקשר דיווח אחד, אבל לא בכל הקשרי הדיווח שהוגדרו להם. אתם יכולים לבקש את סטטוס המוצר המפורט לפי הקשר של הדיווח ותובנות על מוצרים כדי לבצע בדיקה נוספת. כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה של Merchant Center Query Language אל השיטה accounts.reports.search:
SELECT
id,
offer_id,
feed_label,
title,
aggregated_reporting_context_status,
status_per_reporting_context,
item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'
זוהי דוגמה לתשובה מהשאילתה הקודמת:
{
"results": [
{
"productView": {
"id": "en~US~id0",
"offerId": "id0",
"feedLabel": "US",
"aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
"statusPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
},
{
"reportingContext": "FREE_LISTINGS",
"approvedCountries": [
"US"
]
}
]
"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"
}
]
}
}
]
}
אתם יכולים להשתמש במסנן ב-reporting_context בסעיף WHERE כדי להציג פרטי מוצר בהקשר דיווח ספציפי. כשמסננים לפי reporting_context, המערכת מחשבת את aggregated_reporting_context_status רק על סמך הקשר הנבחר של הדיווח, והפונקציות status_per_reporting_context ו-item_issues מחזירות רק פרטים שקשורים לאותו הקשר.
מידע נוסף על השדות שזמינים לשאילתה מופיע במאמר בנושא שדות בטבלה product_view.
שיפור התמחור
בתצוגת מדדי המחירים תוכלו לראות את מחירי המבצע המומלצים למוצרים שלכם ואת הביצועים הצפויים אם תעדכנו את מחירי המוצרים. הדוח עוזר לכם לתמחר את המוצרים בצורה יעילה יותר.
מידע נוסף זמין במאמר שיפור התמחור של מוצרים בעזרת דוח מדדי המחירים.
שאילתה
price_insights_product_view
כדי לראות הצעות למחירי מבצע למוצרים שלכם.
לפניכם דוגמה שאפשר להשתמש בה כדי לראות את מחירי המבצע המוצעים למוצרים שלכם. כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה של Merchant Center Query Language אל השיטה accounts.reports.search:
SELECT
id,
title,
brand,
price,
suggested_price,
predicted_impressions_change_fraction,
predicted_clicks_change_fraction,
predicted_conversions_change_fraction
FROM price_insights_product_view
זוהי דוגמה לתשובה מהשאילתה הקודמת:
{
"results": [
{
"priceInsightsProductView": {
"id": "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": "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": "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"
}
}
]
}
מידע נוסף על השדות שזמינים לשאילתה מופיע במאמר בנושא שדות בטבלה priceInsightsProductView.