تقييم منتجاتك

يمكنك استخدام 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 للمنتج.

يمكنك الفلترة استنادًا إلى جميع الحقول المتاحة، باستثناء ما يلي:

  • status_per_reporting_context
  • item_issues

يمكنك ترتيب الردّ استنادًا إلى جميع الحقول المتاحة باستثناء ما يلي:

  • gtin
  • status_per_reporting_context
  • item_issues

يمكنك الاطّلاع على الحقل aggregated_reporting_context_status لفهم أهلية المنتج بشكل عام. يجمع هذا الحقل الحالات في جميع سياقات عرض تقارير المنتج.

في ما يلي مثال يعرض منتجاتك التي تحمل الحالة المجمّعة ELIGIBLE_LIMITED، ما يعني أنّها مؤهّلة للعرض في سياق واحد على الأقل من سياقات عرض التقارير المستهدَفة، ولكن ليس في كلّها. يمكنك طلب حالة المنتج التفصيلية لكل سياق عرض تقارير ومشاكل المنتج لمزيد من التحقيق. لإجراء الطلب، مرِّر عبارة لغة طلبات البحث في Merchant Center التالية إلى طريقة 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 التالية إلى طريقة 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.