אתם יכולים להשתמש ב-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 ל-method 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 ל-method 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 ל-method 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.