ارزیابی محصولات

می‌توانید از 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 را برای همه محصولات در حسابتان درطول یک دوره ۳۰ روزه خاص بازیابی می‌کند. برای ارائه درخواست، عبارت 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_context
  • item_issues

می‌توانید پاسخ را براساس همه فیلدهای دردسترس به‌جز موارد زیر مرتب کنید:

  • gtin
  • status_per_reporting_context
  • item_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 مراجعه کنید.