Performance reports

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": "4,440"
      }
    }
  ]
}

路段

您可以使用區隔欄位，在成效報表中劃分資料。舉例來說，查詢 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 在同一個查詢中指定多個區隔。

以下是範例查詢，會根據 marketing_method 和 offer_id 區隔帳戶中所有產品的 30 天點擊次數：

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"
        }
      }
    }
  ]
}

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