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

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

لمزيد من المعلومات حول تقارير الأداء، يُرجى الاطّلاع على دليل تقارير الأداء.

فلترة المنتجات

يمكنك استخدام واجهة برمجة التطبيقات Merchant Reports API product_view لعرض بيانات منتجاتك بعد فلترتها، بما في ذلك حالات المنتجات. على سبيل المثال، يمكنك طلب 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.