區隔

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

報表會將每個層級分別傳回至各自的欄位，如下所示：

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

Buy on Google 指標

已淘汰： 系統不再支援 Buy on Google 指標，自 2024 年 5 月起，擷取這些指標會傳回 0 (包括過去日期的歷來值)。

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

瞭解詳情

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