概览

Reporting API

通过 Reporting API，商家可以与其效果数据进行互动 通过 Merchant Center 查询语言以编程方式类似于 能够 创建自定义报告 直接在 Merchant Center 中操作Reporting API 具有以下优势：

  • 允许大型商家将产品详情的效果数据导入到 内部或第三方报告系统。
  • 允许用户、第三方合作伙伴和集合商家管理商家 中心账号访问权限报告。

API 用户可以指定要在 搜索呼叫响应，例如：

  • 要返回的指标（例如：点击次数、展示次数）
  • 数据细分维度（例如：OfferId、Date）
  • 需要满足的条件（例如：点击次数 > 100）

Reporting API 查询语言可以查询用于购物的 Content API for Shopping 效果指标（点击次数、展示次数），可能按各种 维度（报告的事件属性，如计划和日期，以及产品 属性（例如品牌、类别等），对Search Reports 服务。

对 Reports 服务的查询的结果是一个 ReportRow 列表 实例，其中每个 ReportRow 表示所请求指标的值 创建细分受众群如果未指定任何细分，则将单个 行，以及所有细分的汇总指标。否则，如果有 同时请求了细分和指标，则响应会显示 每个唯一片段元组。您可以选择多个细分并 在单个查询中使用多个指标。

查询指标

您可以查询所需的指标（点击次数、展示次数、点击率等） 返回。您必须添加针对日期范围的过滤器，才能查询报告 服务。以下示例查询会返回一行：汇总金额 特定日期范围内所添加条件的点击次数。

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

响应示例

以下示例 JSON 代码响应显示了此商家如何获得了 4,440 次点击 对所有目标平台的所有商品进行汇总 2020 年 12 月 1 日和 2020 年 12 月 21 日。

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

查询细分

除了指标之外，您还可以查询细分，细分是 商品（offer_id、brand、category 等）或所报告的 事件（date、program）。报告的事件是指 产品。

细分的作用类似于 SQL 中的 GROUP BY。可拆分所选内容的细分 指标，按 SELECT 子句中的每个细分进行分组。以下示例查询 返回每天的点击次数，按照所添加条件的点击次数降序排列 日期范围的数据只有至少有一个请求的指标为非零的行才会 返回。

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

响应示例

以下示例 JSON 代码响应显示了此商家如何获得了 1,546 次点击 2020 年 12 月 1 日，针对自己所有目标平台的所有商品展开宣传 在客户所有平台上的所有平台上，他们的所有产品均获得了 829 次点击 2020 年 12 月 2 日自 2020 年 12 月 3 日起， 商家在当天未获得任何点击。

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