Merchant API 提供效果报告，例如 product_performance_view。
本页将介绍效果报告的结构。
指标
您可以查询要返回的指标（例如 clicks 和 impressions）。您必须添加日期范围过滤条件，才能查询 Reports 服务以获取效果数据。
以下是一个示例查询，该查询会返回一行数据，其中包含指定日期范围内的总点击次数：
SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'
您必须指定要返回的数据。通配符（例如 SELECT
*）会返回错误。
以下示例响应显示，在 2023 年 12 月 1 日至 2023 年 12 月 21 日期间，该商家通过所有营销方法获得的所有产品的总点击次数为 4,440 次。
{
"results": [
{
"productPerformanceView": {
"clicks": "4,440"
}
}
]
}
细分
您可以使用细分字段在效果报告中进行细分。
例如，查询 marketing_method 会返回一份报告，其中包含每个营销方法的相应行，以及您在 SELECT 子句中为相应营销方法指定的指标。
细分字段可以是商品属性（例如 offer_id、brand 和 category），也可以是事件属性（例如 date 和 marketing_method）。
细分字段的作用类似于 SQL 中的 GROUP BY。细分字段会拆分所选指标，并按 SELECT 子句中的每个细分进行分组。
以下是一个示例查询，该查询会返回每天的点击次数，并按 clicks 降序排列，同时添加了日期范围条件。系统只会返回至少一个所请求的指标不为零的行。
SELECT
date,
clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC
以下示例响应显示，某商家在 2023 年 12 月 1 日通过所有营销方法获得的所有商品的点击次数为 1,546 次，在 2023 年 12 月 2 日通过所有营销方法获得的所有商品的点击次数为 829 次。商家在 2023 年 12 月 3 日没有获得任何点击，因此该日期没有任何返回结果。
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}
与 Merchant Center 中的自定义报告一样，您可以使用 Merchant Reports API 在同一查询中指定多个细分。
以下是一个示例查询，用于返回账号中所有商品在 30 天内的点击次数，并按 marketing_method 和 offer_id 进行细分：
SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'
此查询的响应包含 offer_id 和 marketing_method 的每种组合所对应的一行，其中包含相应组合的点击次数：
{
"results": [
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12345",
"clicks": "38"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12346",
"clicks": "125"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12346",
"clicks": "23"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12347",
"clicks": "8"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12347",
"clicks": "3"
}
}
]
}
类别和商品类型
Merchant Center 查询语言支持按两组属性细分指标，您可以定义这些属性来整理您的商品目录：
- 类别级别
- 来自 Google 商品类目的类别。如果您未提供类别，Google 可能会自动为您的商品分配类别，或者进一步细化您提供的类别。
- 商品类型级别
- 您根据自己的分类分配的商品类型。与类别级别不同，没有预定义的受支持值集。
“类别”属性和“商品类型”属性都按多级层次结构整理。产品规范使用 > 字符分隔每个级别，但您可以在报告中单独选择层次结构的每个级别。
例如，假设某产品具有以下产品类型级别：
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
报告会以单独的字段返回每个级别：
| Segment | 值 |
|---|---|
product_type_l1 |
Home & Garden |
product_type_l2 |
Kitchen & Dining |
product_type_l3 |
Kitchen Appliances |
product_type_l4 |
Refrigerators |
币种和价格指标
价格指标（例如 conversion_value）使用 Price 类型表示。如果相应指标有多种币种，则每种币种的值都会单独显示在一行中。例如，以下查询：
SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'
返回以下结果：
{
"results": [
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
如果您在查询中同时请求价格指标和非价格指标，则价格指标会与非价格指标分开返回到不同的结果行中，每个币种代码对应一个结果行。例如，以下查询：
SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'
返回以下响应：
{
"results": [
{
"productPerformanceView": {
"conversions": "27",
"conversionValue": {
"amountMicros": "0",
"currencyCode": ""
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
即使所选字段的值仍为默认值或零，系统也会在响应中返回所有这些字段。
如需详细了解可用于查询的字段，请参阅productPerformanceView 表中的字段。