此页面由 Cloud Translation API 翻译。

概览

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"
      }
    }
]}