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

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

قياس الأداء

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

المتطلبات

يجب الاطّلاع على الأداء والإحصاءات الدور لاسترداد هذا التقرير.

لمنح أحد الحسابات دور الأداء والإحصاءات، عليك تصحيح User للحساب الذي يتضمن PERFORMANCE_REPORTING حق الوصول.

accounts.v1beta.accounts.users.patch تستبدل مورد User بأكمله. لتجنّب فقدان المعلومات، يمكنك الاتصال على الرقم accounts.v1beta.accounts.users.get. للحصول على مورد User بالكامل، ثم قدِّم جميع الحقول في طلب accounts.v1beta.accounts.users.patch.

نموذج طلب بحث

يسترد الاستعلام التالي 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'

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

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

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

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

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

• gtin
• itemIssues

في ما يلي مثال على إرجاع منتجاتك بالحالة NOT_ELIGIBLE_OR_DISAPPROVED لتقديم الطلب، يُرجى إبلاغ التاجر التالي لغة طلب البحث المركزي إلى الـ 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"
      }
    }
  ]
}