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": "4440"
}
}
]
}
细分
您可以使用细分
字段进行
细分，以生成效果
报告。
例如，查询 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
报告会在各自的字段中返回每个级别：
| 细分 | 值 |
|---|---|
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