分割

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

注意 ：为使 SELECT 子句与响应中的每个 ReportRow 之间的清晰性和一致性，您可能仍需要在查询中明确添加 segments.currency_code。

Google 易购指标

已弃用： “在 Google 上购买”指标不再受支持，自 2024 年 5 月起，检索这些指标时，会返回 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

了解详情

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