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

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