您可以使用 Merchant Reports API 查看成效資料、依特定屬性篩選產品,以及改善價格。
評估效能
您可以使用 Merchant Reports API ProductPerformanceView
擷取帳戶的效能指標。
需求條件
您必須具備成效與深入分析角色,才能擷取這份報表。
如要授予帳戶效能與深入分析角色,請使用 Content API for Shopping 的 accounts.update
方法,將 reportsManager
欄位設為 true
。
accounts.update
會取代整個 Account
資源。請使用 accounts.get
取得完整的 Account
資源,然後在 accounts.update
要求中提供所有欄位,以免遺失資訊。
查詢範例
以下查詢會擷取帳戶中在過去 30 天內所有產品的 impressions
、clicks
和 clickThroughRate
。如要提出要求,請將下列 Merchant Center Query Language 陳述式傳遞至 accounts.reports.search
方法:
SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
您也可以區隔查詢中的指標,取得更精細的成效報表。
篩選產品
您可以使用 Merchant Reports API 的 ProductView
,顯示包含產品狀態的篩選檢視畫面。舉例來說,您可以查詢 ProductView
來列出有問題的產品,或是取得新產品的清單和驗證服務。
您必須在查詢的 SELECT
子句中加入 id
欄位。id
的值與產品的 REST ID 相同。
您可以根據所有可用欄位進行篩選 (itemIssues
除外)。您可以根據所有可用的欄位排序回應,但以下項目除外:
gtin
itemIssues
以下範例說明如何傳回 NOT_ELIGIBLE_OR_DISAPPROVED
狀態的產品。如要提出要求,請將下列 Merchant Center 查詢語言陳述式傳遞至 accounts.reports.search
方法:
SELECT
id,
offerId,
feedLabel,
title,
aggregatedReportingContextStatus
itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'
以下是上述查詢的範例回應:
{
"results": [
{
"productView": {
"id": "online~en~US~id0"
"offerId": "id0",
"feedLabel": "US",
"aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
"itemIssues": [
{
"type": {
"code": "invalid_string_value",
"canonicalAttribute": "n:product_code"
},
"severity": {
"severityPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
},
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"aggregatedSeverity": "DISAPPROVED"
},
"resolution": "MERCHANT_ACTION"
},
{
"type": {
"code": "apparel_missing_brand",
"canonicalAttribute": "n:brand"
},
"severity": {
"severityPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
}
],
"aggregatedSeverity": "DEMOTED"
},
"resolution": "MERCHANT_ACTION"
}
]
}
}
]
}
如要進一步瞭解特定欄位和行為,請參閱 ProductView
參考資料。
提高價格
您可以查看價格分析檢視畫面,查看產品的建議特價,以及更新產品價格後預期可達到的成效。價格分析報表可協助您更有效地設定產品價格。
詳情請參閱「透過價格分析報表改善產品價格」。
查詢 PriceInsightsProductView
即可查看產品的建議特價。
以下提供範例,方便您查看產品的建議特價。如要提出要求,請將下列 Merchant Center Query Language 陳述式傳遞至 accounts.reports.search
方法:
SELECT
id,
title,
brand,
price,
suggested_price,
predictedImpressionsChangeFraction,
predictedClicksChangeFraction,
predictedConversionChangeFraction
FROM PriceInsightsProductView
以下是上述查詢的範例回應:
{
"results": [
{
"priceInsightsProductView": {
"id": "online~en~US~12345",
"title": "UGG Women's s Classic Mini",
"brand": "UGG",
"price" {
"amountMicros": "124990000",
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "135680000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.12609300017356873",
"predictedClicksChangeFraction": "0.508745014667511",
"predictedConversionsChangeFraction": "2.3431060314178467"
}
},
{
"priceInsightsProductView": {
"id": "online~en~US~12346",
"title": "Nike React Infinity Run Flyknit 2",
"brand": "Nike",
"price" {
"amountMicros": "119990000"
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "125440000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.1799899935722351",
"predictedClicksChangeFraction": "0.6203680038452148",
"predictedConversionsChangeFraction": "1.234868049621582"
}
},
{
"priceInsightsProductView": {
"id": "online~en~US~12347",
"title": " New Balance 327 White Trainers",
"brand": "New Balance",
"price" {
"amountMicros": "84990000"
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "82000000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.11538799852132797",
"predictedClicksChangeFraction": "0.5869849920272827",
"predictedConversionsChangeFraction": "1.3622850179672241"
}
}
]
}