在 Merchant Center 自訂報表中提供的區隔,可在報表 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'
按一下「Run」,即可在 API Explorer 中試用範例。按一下「執行」後,請將要求網址中的商家 ID 預留位置更新為您自己的商家 ID。您可以修改查詢。完整查詢必須留在單一行,才能與 API Explorer 搭配運作。
將這項查詢傳送至 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
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_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
瞭解詳情
如需完整的區隔清單,請參閱說明文件。