评估您的商品

您可以使用 Merchant Reports API 查看效果数据、按特定属性过滤商品以及优化价格。

衡量性能

您可以使用 Merchant Reports API ProductPerformanceView 来检索帐号的效果指标。

要求

您需要拥有“性能和数据分析”角色才能检索此报告。

如需为帐号提供“效果和数据分析”角色，请使用 Content API for Shopping 的 accounts.update 方法将 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'

您还可以细分查询中的指标，以查看更精细的效果报告。

过滤商品

您可以使用 Merchant Reports API 的 ProductView 来显示经过过滤的产品数据视图，包括产品状态。例如，您可以查询 ProductView 以列出存在问题的产品，或者获取新产品的列表并验证服务。

您必须在查询的 SELECT 子句中添加 id 字段。id 的值与产品的 REST ID 相同。

您可以根据除 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"
      }
    }
  ]
}