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

يمكنك استخدام 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 التالي إلى الأسلوب 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 ID للمنتج.

يمكنك الفلترة استنادًا إلى جميع سمات المتاحة، باستثناء 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 Query Language التالية إلى accounts.reports.search method:

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.