分割

Merchant Center 中提供的细分 自定义报告， 通过向查询添加适当的字段来实现在 Reporting API 中实现。对于 例如，查询 segments.program 会生成一个报告，其中每个 计划（购物广告、非付费商品详情等），其中会包含这些指标 （展示次数、点击次数等），如SELECT 子句。

与 Merchant Center 中的自定义报告一样，您可以指定多个细分 。

以下示例查询检索您账号中所有商品的点击次数 在 30 天内按“program”和“offer_id”细分：

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

运行

点击运行，在 API Explorer 中试用该示例。点击 运行，在 请求网址。您可以修改查询。完整查询必须占一行， 使用 API Explorer。

将此查询发送到 reports.search 的结果是一行，指定了 每个 offer_id 和 program 组合的点击次数，如下例所示 JSON 字符串：

{
  "results": [
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "38"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "125"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "23"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "8"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "3"
      }
    }
  ]
}

类别和产品类型

Merchant Center 查询语言支持按两组 您可以定义以下属性来整理广告资源：

类别级别（segments.category_l1、segments.category_l2 等）
类别来源 Google 的商品类目。 如果未提供任何类别，Google 可能会自动为您的商品分配类别，或者 进一步优化提供的类别。
产品类型级别（segments.product_type_l1、segments.product_type_l2 等）
根据分类进行分配。 与类别级别不同的是，类别级别不存在预定义的一组支持值。

“类别”和“商品类型”属性都按照 多个级别。通过 商品规格 每个层级包含 > 字符，但您可以选择层次结构的每个层级 。

例如，假设某个产品具有以下产品类型级别：

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

报告将在自己的字段中返回各个级别，如下所示：

分割部分 值
segments.product_type_l1 Home & Garden
segments.product_type_l2 Kitchen & Dining
segments.product_type_l3 Kitchen Appliances
segments.product_type_l4 Refrigerators

货币和价格指标

ReportRow 的 segments.currency_code 字段表示 metrics.conversion_value_micros 等价格指标。 这对于正确解读这些指标非常重要， 返回的ReportRow将自动包含segments.currency_code 。

  • metrics.conversion_value_micros
。
  • metrics.aov_micros
  • metrics.ordered_item_sales_micros
  • metrics.returns_micros
  • metrics.shipped_item_sales_micros
。

Google 易购指标

Merchant Center 查询语言支持“在 Google 上购买”的两类指标 Google 订单：商品级指标和订单级指标。

商品级指标

根据订单中的商品计算得出的指标，并与 每个订单中商品的尺寸。

  • metrics.item_days_to_ship
  • metrics.item_fill_rate
  • metrics.ordered_items
  • metrics.ordered_item_sales_micros
  • metrics.rejected_items
  • metrics.returned_items
  • metrics.return_rate
  • metrics.returns_micros
  • metrics.shipped_items
  • metrics.shipped_item_sales_micros
  • metrics.unshipped_items
订单级指标

按订单计算的指标。

  • metrics.aos
  • metrics.aov_micros
  • metrics.days_to_ship
  • metrics.orders
  • metrics.shipped_orders
  • metrics.unshipped_orders

订单级指标不与 每个订单中的商品。

您可以选择商品级指标以及任何可用的细分。 不过，如果同时选择订单级指标和以下任意一项， 以下产品维度细分将失败：

  • segments.brand
  • segments.category_l1、segments.category_l2、segments.category_l3、segments.category_l4、segments.category_l5
  • segments.custom_label1、segments.custom_label2、segments.custom_label3、segments.custom_label4、segments.custom_label5
  • segments.offer_id
  • segments.product_type_l1、segments.product_type_l2、segments.product_type_l3、segments.product_type_l4、segments.product_type_l5
  • segments.title

了解详情

有关细分的完整列表，请查看 文档。