區隔

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

報表會在每個層級分別傳回,如下所示:

區隔 價值
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

Buy on Google 指標

Merchant Center 查詢語言支援兩種 Buy on 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

瞭解詳情

如需完整區隔清單,請參閱說明文件