分割

您可以在 Merchant Center 自定义报告中使用细分功能,只需将相应字段添加到查询中,即可在 Reporting API 中 实现细分。例如,查询 segments.program 会生成一份报告,其中包含每个计划(购物广告、非付费商品详情等)的行,这些行包含该计划的指标(展示次数、点击次数等),如 SELECT 子句中所指定。

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

以下示例查询检索了您账号中所有产品在 30 天内的点击次数,并按 programoffer_id 进行了细分:

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

运行

点击 Run (运行),即可在 API Explorer 中试用该示例。点击 Run(运行)后,请将请求网址中的商家 ID 占位符更新为您自己的商家 ID。您可以修改查询。完整查询必须保留在一行中,才能与 API Explorer 搭配使用。

将此查询发送到 reports.search 后,返回的结果是一行,其中指定了 offer_idprogram 的每种组合的点击次数,如以下示例 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_l1segments.category_l2 等)
Google 商品类目中的类别 。 如果未提供类别,Google 可能会自动为您的商品分配类别,或者进一步优化提供的类别。
商品类型级别(segments.product_type_l1segments.product_type_l2 等)
您根据自己的分类分配的商品类型。与类别级别不同,没有预定义的一组受支持值。

类别和商品类型属性都按具有多个级别的层次结构进行整理。商品规范使用 > 字符分隔每个级别,但您可以在报告中单独选择层次结构的每个级别。

例如,假设某个产品具有以下商品类型级别:

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

报告将在各自的字段中返回每个级别,如下所示:

Segment Value
segments.product_type_l1 Home & Garden
segments.product_type_l2 Kitchen & Dining
segments.product_type_l3 Kitchen Appliances
segments.product_type_l4 Refrigerators

币种和价格指标

ReportRowsegments.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_l1segments.category_l2segments.category_l3segments.category_l4segments.category_l5
  • segments.custom_label1segments.custom_label2segments.custom_label3segments.custom_label4segments.custom_label5
  • segments.offer_id
  • segments.product_type_l1segments.product_type_l2segments.product_type_l3segments.product_type_l4segments.product_type_l5
  • segments.title

了解详情

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