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 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 tại, 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}: Giá trị 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ò.
Cụm từ tìm kiếm mẫu
Cụm từ tìm kiếm sau đây sẽ 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 truyề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 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 để hiển thị chế độ xem được lọc của dữ liệu sản phẩm, 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 có vấn đề hoặc để nhận danh sách sản phẩm mới và xác minh việc phân phát.
Bạn phải thêm trường id vào mệnh đề SELECT trong truy vấn của mình. id có cùng giá trị với REST ID của sản phẩm.
Bạn có thể lọc dựa trên tất cả các trường có sẵn, ngoại trừ item_issues. Bạn có thể sắp xếp phản hồi dựa trên tất cả các trường có sẵn, ngoại trừ các trường sau:
gtinitem_issues
Sau đây là ví dụ trả về các sản phẩm của bạn có trạng thái NOT_ELIGIBLE_OR_DISAPPROVED. Để đưa ra yêu cầu, hãy truyề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,
offer_id,
feed_label,
title,
aggregated_reporting_context_status,
item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'
Sau đây là một phản hồi mẫu từ truy vấn trước:
{
"results": [
{
"productView": {
"id": "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"
}
]
}
}
]
}
Để biết thêm thông tin về các trường có sẵn cho truy vấn, hãy xem phần Các trường trong bảng productView.
Cải thiện giá
Bạn có thể sử dụng chế độ xem 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 bài viết 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 của bạn.
Sau đây là một mẫu mà bạn có thể dùng để xem giá ưu đãi được đề xuất cho sản phẩm của mình. Để đưa ra yêu cầu, hãy truyề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_conversion_change_fraction
FROM price_insights_product_view
Sau đây là một 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 phần Các trường trong bảng priceInsightsProductView.