评估您的商品

您可以使用 Merchant Reports API 查看效果 数据，请按以下条件过滤产品： 特定属性，并提高价格。

衡量性能

您可以使用 Merchant Reports API ProductPerformanceView 获取 指标。

要求

您需要了解性能和数据分析 角色以获取此报告。

如需为账号授予“Performance and Insights”（效果和数据洞见）角色，请修补 User 为具有 PERFORMANCE_REPORTING 访问权限。

accounts.v1beta.accounts.users.patch 会替换整个 User 资源。为避免丢失信息，请调用 accounts.v1beta.accounts.users.get 以获取完整的 User 资源，然后在您的 accounts.v1beta.accounts.users.patch 请求。

示例查询

以下查询会检索 impressions、clicks 和 在特定 30 天内，为您账号中的所有商品支付 clickThroughRate 。要发出请求，请传递以下 Merchant Center 查询 Language 语句添加到 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 查询 Language 语句添加到 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"
      }
    }
  ]
}