您可以使用 Merchant Reports API 查看成效資料、依特定屬性篩選產品,以及改善價格設定。
衡量成效
您可以使用 Merchant Reports API product_performance_view
擷取帳戶的成效指標。
需求條件
如要擷取這份報表,您必須具備成效和洞察角色。
如要為帳戶授予成效和洞察角色,請使用 PERFORMANCE_REPORTING
存取權,為帳戶修補 User
資源。如要完成這項操作,請將整個 User
資源替換為 accounts.v1beta.accounts.users.patch
。
為避免遺失資訊,請呼叫 accounts.v1beta.accounts.users.get
取得完整的 User
資源,然後在 accounts.v1beta.accounts.users.patch
要求中提供所有欄位。
查詢範例
以下查詢會擷取帳戶中所有產品在特定 30 天期間的 impressions
、clicks
和 click_through_rate
。如要提出要求,請將下列 Merchant Center Query Language 陳述式傳遞至 accounts.reports.search
方法:
SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
如要進一步瞭解成效報表,請參閱「成效報表」指南。
篩選產品
你可以使用 Merchant Reports API 的 product_view
顯示經過篩選的產品資料檢視畫面,包括產品狀態。舉例來說,您可以查詢 product_view
來列出有問題的產品,或是取得新產品清單並驗證放送狀況。
您必須在查詢的 SELECT
子句中加入 id
欄位。id
的值與產品的 REST ID 相同。
您可以根據所有可用欄位進行篩選,但 item_issues
除外。您可以根據所有可用欄位排序回應,但下列欄位除外:
gtin
item_issues
以下範例會傳回狀態為 NOT_ELIGIBLE_OR_DISAPPROVED
的產品。如要提出要求,請將下列 Merchant Center Query Language 陳述式傳遞至 accounts.reports.search
方法:
SELECT
id,
offer_id,
feed_label,
title,
aggregated_reporting_context_status,
item_issues
FROM product_view
WHERE aggregated_reporting_context_status = '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
資料表中的欄位」。
改善定價
你可以透過價格深入分析檢視畫面,查看產品的建議特價,以及更新產品價格後的預期成效預測。價格深入分析報表可協助你更有效地設定產品價格。
詳情請參閱「透過價格分析報表改善產品價格」。
查詢 price_insights_product_view
即可查看產品的建議特價。
以下是產品建議特價的範例。如要提出要求,請將下列 Merchant Center Query Language 陳述式傳遞至 accounts.reports.search
方法:
SELECT
id,
title,
brand,
price,
suggested_price,
predicted_impressions_change_fraction,
predicted_clicks_change_fraction,
predicted_conversion_change_fraction
FROM price_insights_product_view
以下是上述查詢的回應範例:
{
"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"
}
}
]
}
如要進一步瞭解可供查詢的欄位,請參閱「priceInsightsProductView
資料表中的欄位」。