分割

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

与 Merchant Center 中的自定义报告一样，您可以使用 Reporting API 在同一查询中指定多个细分。

以下示例查询会检索您账号中所有产品在 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 中试用该示例。点击运行后，请将请求网址中的商家 ID 占位符更新为您自己的商家 ID。您可以修改查询。完整查询必须保持在一行中，才能与 API 浏览器搭配使用。

向 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

报告将以单独的字段返回每个级别，如下所示：

Segment	值
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

注意： 为了确保清晰度以及SELECT子句与回答中的每个ReportRow之间的一致性，您可能仍希望在查询中明确包含 segments.currency_code。

“在 Google 上购买”指标

已弃用： 自 2024 年 5 月起，“在 Google 上购买”指标不再受支持，检索这些指标会返回 0（包括过去日期的历史值）。

Merchant Center 查询语言支持两类“在 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

了解详情

如需查看完整的细分列表，请参阅文档。