Bạn có thể sử dụng Merchant Reports API để xem dữ liệu hiệu suất , lọc sản phẩm theo các thuộc tính cụ thể và cải thiện cách định giá.
Đo lường hiệu suất
Bạn có thể truy xuất
các chỉ số hiệu suất
cho tài khoản của mình bằng Merchant Reports API
product_performance_view.
Yêu cầu
Để truy xuất báo cáo này, bạn cần có vai trò Hiệu suất và thông tin chi tiết.
Để chỉ định vai trò Hiệu suất và thông tin chi tiết cho một người dùng hiện có, hãy tạo một yêu cầu
vá và
chỉ định quyền truy cập PERFORMANCE_REPORTING cho người dùng đó. Yêu cầu sau đây cho biết cách bạn có thể tạo một yêu cầu vá để chỉ định quyền truy cập PERFORMANCE_REPORTING:
PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}
{
"accessRights": [
"PERFORMANCE_REPORTING"
]
}
Thay thế nội dung sau:
- {ACCOUNT_ID}: Mã nhận dạng duy nhất của tài khoản Merchant Center.
- {EMAIL_ID}: Địa chỉ email của người dùng mà bạn muốn chỉ định vai trò.
Truy vấn mẫu
Truy vấn sau đây truy xuất impressions, clicks và click_through_rate cho tất cả sản phẩm trong tài khoản của bạn trong một khoảng thời gian cụ thể là 30 ngày. Để đưa ra yêu cầu, hãy chuyển câu lệnh Ngôn ngữ truy vấn
Merchant Center sau đây đến phương thức
accounts.reports.search:
SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
Để biết thêm thông tin về báo cáo hiệu suất, hãy xem hướng dẫn về Báo cáo hiệu suất.
Lọc sản phẩm
Bạn có thể sử dụng
product_view
của Merchant Reports API để xem dữ liệu sản phẩm đã lọc, bao gồm cả trạng thái sản phẩm. Ví dụ: bạn có thể truy vấn product_view để liệt kê các sản phẩm gặp vấn đề hoặc để xem danh sách sản phẩm mới và xác minh việc phân phát.
Bạn phải đưa trường id vào mệnh đề SELECT của truy vấn. id
có cùng giá trị với mã nhận dạng REST
của sản phẩm.
Bạn có thể lọc dựa trên tất cả các trường hiện có, ngoại trừ các trường sau:
status_per_reporting_contextitem_issues
Bạn có thể sắp xếp phản hồi dựa trên tất cả các trường hiện có, ngoại trừ các trường sau:
gtinstatus_per_reporting_contextitem_issues
Bạn có thể kiểm tra trường aggregated_reporting_context_status để hiểu rõ điều kiện tổng thể của một sản phẩm. Trường này tổng hợp các trạng thái trên tất cả bối cảnh báo cáo của một sản phẩm.
Dưới đây là ví dụ trả về các sản phẩm có trạng thái tổng hợp là ELIGIBLE_LIMITED, nghĩa là các sản phẩm đó đủ điều kiện phân phát trong ít nhất một bối cảnh báo cáo mục tiêu, nhưng không phải tất cả. Bạn có thể yêu cầu trạng thái sản phẩm chi tiết theo bối cảnh báo cáo và các vấn đề về sản phẩm để điều tra thêm. Để đưa ra
yêu cầu, hãy chuyển câu lệnh Ngôn ngữ truy vấn Merchant Center sau đây
đến
accounts.reports.search
phương thức:
SELECT
id,
offer_id,
feed_label,
title,
aggregated_reporting_context_status,
status_per_reporting_context,
item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'
Dưới đây là phản hồi mẫu từ truy vấn trước:
{
"results": [
{
"productView": {
"id": "en~US~id0",
"offerId": "id0",
"feedLabel": "US",
"aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
"statusPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
},
{
"reportingContext": "FREE_LISTINGS",
"approvedCountries": [
"US"
]
}
]
"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"
}
]
}
}
]
}
Bạn có thể sử dụng bộ lọc trên reporting_context trong mệnh đề WHERE để xem thông tin chi tiết về sản phẩm cho một bối cảnh báo cáo cụ thể. Khi bạn lọc theo
reporting_context, aggregated_reporting_context_status chỉ được tính dựa trên
bối cảnh báo cáo đã chọn, còn status_per_reporting_context và
item_issues chỉ trả về thông tin chi tiết cho bối cảnh đó.
Để biết thêm thông tin về các trường có sẵn cho truy vấn, hãy xem
Các trường trong bảng product_view.
Cải thiện cách định giá
Bạn có thể sử dụng khung hiển thị thông tin chi tiết về giá để xem giá ưu đãi được đề xuất cho sản phẩm và dự đoán hiệu suất mà bạn có thể đạt được nếu cập nhật giá sản phẩm. Việc khai thác báo cáo thông tin chi tiết về giá có thể giúp bạn định giá sản phẩm một cách hiệu quả hơn.
Để biết thêm thông tin, hãy xem Cải thiện cách định giá sản phẩm bằng báo cáo thông tin chi tiết về giá.
Truy vấn
price_insights_product_view
để xem giá ưu đãi được đề xuất cho sản phẩm.
Dưới đây là mẫu mà bạn có thể sử dụng để xem giá ưu đãi được đề xuất cho sản phẩm. Để
đưa ra yêu cầu, hãy chuyển câu lệnh Ngôn ngữ truy vấn
Merchant Center sau đây đến phương thức
accounts.reports.search:
SELECT
id,
title,
brand,
price,
suggested_price,
predicted_impressions_change_fraction,
predicted_clicks_change_fraction,
predicted_conversions_change_fraction
FROM price_insights_product_view
Dưới đây là phản hồi mẫu từ truy vấn trước:
{
"results": [
{
"priceInsightsProductView": {
"id": "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": "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": "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"
}
}
]
}
Để biết thêm thông tin về các trường có sẵn cho truy vấn, hãy xem Các trường trong bảng priceInsightsProductView.