分割

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

Google 易购指标

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

了解详情

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