Performance reports

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

指标

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

下面是一个查询示例，该查询会返回一行，并显示指定日期范围内的总点击次数：

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

您必须指定想要返回的数据。通配符（例如 SELECT *）会返回错误。

以下示例响应显示，在 2020 年 12 月 1 日到 2020 年 12 月 21 日期间，商家在所有营销方法中总共获得了 4,440 次点击。

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

路段

您可以使用 MCQL 查询细分字段。细分字段可以是产品属性（例如 offerId、brand 和 category）或事件属性（例如 date 和 marketingMethod）。

细分字段的作用类似于 SQL 中的 GROUP BY。细分字段会拆分所选指标，按 SELECT 子句中的每个细分进行分组。

下面是一个查询示例，它会在已添加的日期范围内，按 clicks 降序返回每日点击次数。仅返回至少一个请求的指标为非零的行。

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

以下示例响应显示，该商家在 2020 年 12 月 1 日在所有营销方式下获得了 1,546 次点击，在 2020 年 12 月 2 日，所有商品在所有营销方式上获得了 829 次点击。该商家在 2020 年 12 月 3 日未获得任何点击，因此该日期不会返回任何内容。

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}