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，在同一個查詢中指定多個區隔。
以下是查詢範例，可傳回帳戶中所有產品在 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"
}
}
}
]
}
即使所選欄位的值仍為預設值或零，系統也會在回應中傳回所有欄位。