您可以使用 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"
}
}
]
}