评估您的商品

您可以使用 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}：您要为其分配角色的用户的电子邮件地址。

示例查询

以下查询检索了您的账号中所有商品在特定 30 天内的 impressions、clicks 和 click_through_rate。如需发出请求，请将以下 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'

如需详细了解效果报告，请参阅 效果报告 指南。

过滤商品

您可以使用 Merchant Reports API product_view 显示商品数据的过滤视图，包括商品状态。例如，您可以查询 product_view 以列出存在问题的商品，或获取新商品列表并验证投放情况。

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

您可以根据所有 可用字段进行过滤， 但以下字段除外：

  • status_per_reporting_context
  • item_issues。

您可以根据所有可用字段对响应进行排序，但以下字段除外：

  • gtin
  • status_per_reporting_context
  • item_issues

您可以查看 aggregated_reporting_context_status 字段，了解商品的整体资格。此字段汇总了商品在所有报告上下文中的状态。

以下示例返回了汇总状态为 ELIGIBLE_LIMITED 的商品，这意味着这些商品有资格在至少一个（但并非全部）目标报告上下文中投放。您可以请求按报告上下文和商品问题列出的详细商品状态，以便进一步调查。如需发出 请求，请将以下 Merchant Center Query Language 语句 传递给 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"
          }
        ]
      }
    }
  ]
}

您可以在 WHERE 子句中使用 reporting_context 过滤器，查看特定报告上下文的商品详情。当您按 reporting_context进行过滤时，系统仅根据所选报告上下文计算aggregated_reporting_context_status，并且status_per_reporting_context和 item_issues仅返回该上下文的详细信息。

如需详细了解可用于查询的字段，请参阅 表中的字段。product_view

改进定价

您可以使用价格分析视图查看商品的建议促销价，以及更新商品价格后的效果预测。使用价格分析报告可以帮助您更有效地为商品定价。

如需了解详情，请参阅借助价格分析报告改善商品定价。

查询 price_insights_product_view 以查看商品的建议促销价。

以下示例可用于查看商品的建议促销价。如需 发出请求，请将以下 Merchant Center Query Language 语句传递给 accounts.reports.search 方法：

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_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

上一页
Get started
下一页
Performance reports