您可以使用 Merchant Reports API 查看效果数据、按特定属性过滤商品，以及优化定价。
衡量性能
您可以使用 Merchant Reports API product_performance_view 检索账号的效果指标。
要求
您需要拥有“效果和数据分析”角色才能检索此报告。
如需向账号授予“效果和数据分析”角色，请使用 PERFORMANCE_REPORTING 访问权限修补账号的 User 资源。
accounts.v1beta.accounts.users.patch 会替换整个 User 资源。为避免丢失信息，请调用 accounts.v1beta.accounts.users.get 以获取完整的 User 资源，然后在 accounts.v1beta.accounts.users.patch 请求中提供所有字段。
示例查询
以下查询会检索您账号中所有产品在特定 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 相同。
您可以根据除 item_issues 之外的所有可用字段进行过滤。您可以按以下字段以外的所有可用字段对响应进行排序：
gtinitem_issues
下面的示例会返回状态为 NOT_ELIGIBLE_OR_DISAPPROVED 的商品。如需发出请求，请将以下 Merchant Center 查询语言语句传递给 accounts.reports.search 方法：
SELECT
id,
offer_id,
feed_label,
title,
aggregated_reporting_context_status
item_issues
FROM ProductView
WHERE aggregated_reporting_context_status = '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"
}
]
}
}
]
}
如需详细了解特定字段和行为，请参阅 product_view 参考文档。
优化定价
您可以使用价格分析视图查看商品的建议促销价，以及更新商品价格后的效果预测。使用价格分析报告可以帮助您更有效地为商品定价。
如需了解详情，请参阅使用价格分析报告改善商品定价。
查询 price_insights_product_view 即可查看商品的建议促销价。
您可以使用以下示例查看商品的建议促销价。如需发出请求，请将以下 Merchant Center 查询语言语句传递给 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": "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"
}
}
]
}