Performance reports

Merchant API 提供效果报告，例如 product_performance_view。本页介绍了效果报告的结构。

指标

您可以查询要返回的指标（例如 clicks 和 impressions）。您必须添加日期范围过滤条件，才能向报告服务查询效果数据。

以下示例查询会返回一行数据，其中包含指定日期范围内的总点击次数：

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 类似。Segments 字段会拆分所选指标，按 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"
        }
      }
    }
  ]
}

系统会在响应中返回您选择的所有字段，即使其值仍为默认值或零也是如此。