Performance reports

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

指标

您可以查询clicksimpressions 。您必须添加日期范围过滤条件才能查询报告 服务来获取性能数据

下面是一个返回单行的示例查询,其中包含总点击次数 在指定日期范围内:

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

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

以下示例响应显示,该商家在当天的总销售额为 4,440 截至 12 月 1 日 2020 年 12 月 21 日。

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

细分

您可以使用 MCQL 查询细分字段。细分字段可以是 商品属性(例如 offerIdbrandcategory)或事件 属性(例如 datemarketingMethod)。

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

下面是一个查询示例,该查询按降序排列每天 clicks(在日期范围的附加条件内)。仅包含至少 一个请求的指标为非零值。

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

以下示例响应显示,该商家在 Google 中共获得了 1,546 次点击 统计的是 2020 年 12 月 1 日、2020 年 12 月 1 日和 829 2020 年 12 月 2 日所有营销方式中所有产品获得的点击次数。 商家在 2020 年 12 月 3 日没有获得任何点击,因此系统不会针对 。

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