محصولات خود را ارزیابی کنید

شما می‌توانید از رابط برنامه‌نویسی کاربردی گزارش‌های فروشنده (Merchant Reports API) برای مشاهده داده‌های عملکرد ، فیلتر کردن محصولات بر اساس ویژگی‌های خاص و بهبود قیمت‌گذاری خود استفاده کنید.

اندازه‌گیری عملکرد

شما می‌توانید معیارهای عملکرد حساب خود را با استفاده از رابط برنامه‌نویسی کاربردی گزارش‌های فروشنده (Merchant Reports API) به نام product_performance_view بازیابی کنید.

الزامات

برای بازیابی این گزارش، باید نقش Performance and insights را داشته باشید.

برای اختصاص نقش Performance و insights به یک کاربر موجود، یک درخواست وصله ایجاد کنید و حق دسترسی PERFORMANCE_REPORTING را به کاربر اختصاص دهید. درخواست زیر نشان می‌دهد که چگونه می‌توانید یک درخواست وصله برای اختصاص حق دسترسی PERFORMANCE_REPORTING ایجاد کنید:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

موارد زیر را جایگزین کنید:

• {ACCOUNT_ID} : شناسه منحصر به فرد حساب مرکز پذیرندگان.
• {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'

برای اطلاعات بیشتر در مورد گزارش‌های عملکرد، به راهنمای گزارش‌های عملکرد مراجعه کنید.

فیلتر کردن محصولات

شما می‌توانید product_view کاربردی گزارش‌های فروشنده (Merchant Reports API) برای نمایش یک نمای فیلتر شده از داده‌های محصول خود، از جمله وضعیت محصول، استفاده کنید. به عنوان مثال، می‌توانید از product_view برای فهرست کردن محصولاتی که مشکل دارند، یا برای دریافت فهرستی از محصولات جدید خود و تأیید ارائه، استفاده کنید.

شما باید فیلد id را در عبارت SELECT کوئری خود وارد کنید. id همان مقدار REST ID محصول را دارد.

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

• gtin
• item_issues

در اینجا مثالی آورده شده است که محصولات شما را با وضعیت NOT_ELIGIBLE_OR_DISAPPROVED برمی‌گرداند. برای ارسال درخواست، عبارت زیر را به Merchant Center Query Language به متد 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 جستجو کنید.

در اینجا نمونه‌ای از قیمت‌های پیشنهادی فروش محصولات شما ارائه شده است. برای ایجاد درخواست، عبارت زیر را به متد accounts.reports.search در مرکز فروشندگان (Merchant Center Query Language) ارسال کنید:

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