הערך את המוצרים שלך

אפשר להשתמש ב-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 לשיטה accounts.reports.search:

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

מידע נוסף על דוחות ביצועים זמין במדריך דוחות ביצועים.

סינון מוצרים

אפשר להשתמש ב-product_view של Merchant Reports API כדי להציג תצוגה מסוננת של נתוני המוצרים, כולל סטטוסי המוצרים. לדוגמה, אפשר להריץ שאילתה ל-product_view כדי לקבל רשימה של מוצרים שיש בהם בעיות, או כדי לקבל רשימה של המוצרים החדשים שלכם ולאמת את הצגתם.

צריך לכלול את השדה id בפסקה SELECT של השאילתה. הערך של id זהה לערך של מזהה ה-REST של המוצר.

אפשר לסנן לפי כל השדות הזמינים, מלבד item_issues. אפשר למיין את התשובה לפי כל השדות הזמינים, מלבד השדות הבאים:

  • gtin
  • item_issues

זו דוגמה להצגת המוצרים עם הסטטוס NOT_ELIGIBLE_OR_DISAPPROVED. כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה של שפת השאילתות של Merchant Center לשיטה accounts.reports.search:

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'

זוהי דוגמה לתגובה מהשאילתה הקודמת:

{
  "results": [
    {
      "productView": {
        "id": "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.

שיפור התמחור

בתצוגה 'מדדי מחירים' אפשר לראות הצעות למחירי מבצע למוצרים שלכם, וגם תחזיות לגבי הביצועים הצפויים אם תעדכנו את מחירי המוצרים. הדוח עוזר לכם לתמחר את המוצרים בצורה יעילה יותר.

מידע נוסף זמין במאמר שיפור התמחור של מוצרים בעזרת דוח מדדי המחירים.

שולחים שאילתה price_insights_product_view כדי להציג הצעות למחירי מבצע למוצרים.

לפניכם דוגמה שבעזרתה תוכלו לראות את הצעות המחיר למבצעים על המוצרים שלכם. כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה בשפת השאילתות של Merchant Center לשיטה accounts.reports.search:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_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.