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

يمكنك استخدام Merchant Reports API لعرض بيانات الأداء وفلترة منتجاتك حسب سمات محدّدة وتحسين الأسعار.

قياس الأداء

يمكنك استخدام Merchant Reports API ProductPerformanceView لاسترداد مقاييس الأداء الخاصة بحسابك.

المتطلّبات

يجب أن يكون لديك دور الأداء والإحصاءات لاسترداد هذا التقرير.

لمنح أحد الحسابات دور "الأداء والإحصاءات"، استخدِم طريقة Content API accounts.update في Shopping لضبط الحقل reportsManager على true.

يحل accounts.update محل مورد Account بالكامل. استخدِم accounts.get للحصول على مورد Account الكامل، ثم أدخِل جميع الحقول في طلب accounts.update كي لا تفقد المعلومات.

نموذج طلب بحث

يسترجع طلب البحث التالي impressions وclicks وclickThroughRate لكل المنتجات في حسابك خلال فترة محددة مدتها 30 يومًا. لتقديم الطلب، مرِّر عبارة لغة طلب البحث في Merchant Center التالية إلى الطريقة accounts.reports.search:

SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

يمكنك أيضًا تقسيم المقاييس في طلب البحث للحصول على تقارير أداء أكثر دقة.

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

يمكنك استخدام واجهة برمجة التطبيقات ProductView في Merchant Reports API للاطّلاع على عرض مفلتر لبيانات المنتجات، بما في ذلك حالات المنتجات. على سبيل المثال، يمكنك إجراء طلب بحث عن ProductView لعرض بيانات المنتجات التي فيها مشاكل أو للحصول على قائمة بمنتجاتك الجديدة والتحقّق من صحة عرض الإعلانات.

يجب تضمين الحقل id في عبارة SELECT من طلب البحث. يتضمّن السمة id القيمة نفسها لمعرّف RST للمنتج.

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

• gtin
• itemIssues

في ما يلي مثال على إرجاع منتجاتك بالحالة NOT_ELIGIBLE_OR_DISAPPROVED. لتقديم الطلب، مرِّر عبارة لغة طلب البحث في Merchant Center التالية إلى الطريقة accounts.reports.search:

SELECT
  id,
  offerId,
  feedLabel,
  title,
  aggregatedReportingContextStatus
  itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'

إليك نموذج رد من الاستعلام السابق:

{
  "results": [
    {
      "productView": {
        "id": "online~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 للحصول على مزيد من المعلومات حول مجالات وسلوكيات محدّدة.

تحسين الأسعار

يمكنك استخدام العرض "معلومات مفصّلة عن الأسعار" للاطّلاع على الأسعار المخفَّضة المقترَحة لمنتجاتك، والاطّلاع على توقّعات حول الأداء الذي يُحتمل أن تحقّقه إذا عدّلت أسعار منتجاتك. ويمكن أن يساعدك استخدام هذا التقرير على تسعير منتجاتك بفعالية أكبر

يمكنك الاطّلاع على تحسين أسعار المنتجات باستخدام تقرير "معلومات مفصّلة عن الأسعار" للحصول على مزيد من المعلومات.

طلب البحث PriceInsightsProductView للاطّلاع على الأسعار المخفَّضة المقترَحة لمنتجاتك

في ما يلي نموذج يمكنك استخدامه لعرض الأسعار المخفَّضة المقترَحة لمنتجاتك. لتقديم الطلب، مرِّر عبارة لغة طلب البحث في Merchant Center التالية إلى طريقة accounts.reports.search:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predictedImpressionsChangeFraction,
  predictedClicksChangeFraction,
  predictedConversionChangeFraction
FROM PriceInsightsProductView

إليك نموذج رد من الاستعلام السابق:

{
   "results": [
    {
      "priceInsightsProductView": {
        "id": "online~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": "online~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": "online~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"
      }
    }
  ]
}