成效報表

Merchant API 提供成效報表,例如 product_performance_view。本頁面說明成效報表的結構。

指標

您可以查詢要傳回的指標 (例如 clicks 和 impressions)。您必須在日期範圍中新增篩選條件,才能向報表服務查詢成效資料。

以下查詢範例會傳回單一資料列,其中包含指定日期範圍內的點擊總數:

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

您必須指定要傳回的資料。萬用字元 (例如 SELECT *) 會傳回錯誤。

以下回應範例顯示,在 2023 年 12 月 1 日至 2023 年 12 月 21 日期間,商家所有產品和行銷方式的總點擊次數為 4,440 次。

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4440"
      }
    }
  ]
}

路段

您可以使用區隔欄位,在成效報表中進行區隔。舉例來說,查詢 marketing_method 會傳回報表,其中每種行銷方式都有一列,以及您在 SELECT 子句中為該行銷方式指定的指標。

區隔欄位可以是產品屬性 (例如 offer_id、brand 和 category) 或事件屬性 (例如 date 和 marketing_method)。

區隔欄位的運作方式與 SQL 中的 GROUP BY 類似。區隔欄位會分割所選指標,並依 SELECT 子句中的每個區隔分組。

以下是查詢範例,可傳回每天的點擊次數,並依 clicks 遞減排序,且加入日期範圍條件。系統只會傳回至少有一項要求指標不為零的資料列。

SELECT
  date,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

下列範例回應顯示,2023 年 12 月 1 日,商家所有產品在所有行銷方式的點擊次數為 1,546 次;2023 年 12 月 2 日,商家所有產品在所有行銷方式的點擊次數為 829 次。商家在 2023 年 12 月 3 日沒有任何點擊,因此系統不會傳回該日期的任何資料。

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}

與 Merchant Center 中的自訂報表一樣,您可以使用 Merchant Reports API 在同一查詢中指定多個區隔。

以下查詢範例會傳回帳戶中所有產品在 30 天內的點擊次數,並依 marketing_method 和 offer_id 區隔:

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

這項查詢的回應包含 offer_id 和 marketing_method 的每個組合,以及該組合的點擊次數:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

類別和產品類型

Merchant Center 查詢語言支援依兩組屬性區隔指標,您可以定義這些屬性來整理商品目錄:

類別層級
Google 產品分類中的類別。如果未提供類別,Google 可能會自動為產品指派類別,或進一步調整提供的類別。
產品類型層級
根據分類指派的產品類型。與類別層級不同,系統沒有預先定義的支援值。

類別和產品類型屬性都以多層級階層結構呈現。產品規格會以 > 字元分隔各個層級,但您可以在報表中分別選取階層的各個層級。

舉例來說,假設某項產品的產品類型層級如下:

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

報表會傳回每個層級的專屬欄位:

區隔 值
product_type_l1 Home & Garden
product_type_l2 Kitchen & Dining
product_type_l3 Kitchen Appliances
product_type_l4 Refrigerators

貨幣和價格指標

價格指標 (例如 conversion_value) 是使用 Price 類型表示。如果指標有多種幣別,則每種幣別的值會分別傳回。請參閱下方查詢範例:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

會傳回下列結果:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

如果您在查詢中同時要求價格和非價格指標,系統會將價格指標和非價格指標分開傳回,每個貨幣代碼會傳回一列結果。請參閱下方查詢範例:

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

會傳回下列回應:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

系統會在回應中傳回您選取的所有欄位,即使其值仍為預設值或零也一樣。

如要進一步瞭解可查詢的欄位,請參閱「productPerformanceView 表格中的欄位」。