Merchant API cung cấp báo cáo hiệu suất, ví dụ:
product_performance_view.
Trang này giải thích cấu trúc của báo cáo hiệu suất.
Chỉ số
Bạn có thể truy vấn các chỉ số (ví dụ: clicks và impressions) mà bạn muốn trả về. Bạn phải thêm bộ lọc cho phạm vi ngày để truy vấn dịch vụ Báo cáo về dữ liệu hiệu suất.
Dưới đây là một truy vấn mẫu trả về một hàng duy nhất, với tổng số lượt nhấp trong phạm vi ngày được chỉ định:
SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'
Bạn phải chỉ định dữ liệu mà bạn muốn trả về. Ký tự đại diện (ví dụ: SELECT
*) sẽ trả về lỗi.
Phản hồi mẫu sau đây cho thấy người bán đã có tổng cộng 4.440 lượt nhấp, trên tất cả sản phẩm, trên tất cả phương pháp tiếp thị, từ ngày 1 tháng 12 năm 2023 đến ngày 21 tháng 12 năm 2023.
{
"results": [
{
"productPerformanceView": {
"clicks": "4440"
}
}
]
}
Phân đoạn
Bạn có thể sử dụng các trường phân đoạn để phân đoạn trong báo cáo hiệu suất.
Ví dụ: khi truy vấn marketing_method, bạn sẽ nhận được một báo cáo có một hàng cho mỗi phương pháp tiếp thị và các chỉ số mà bạn chỉ định cho phương pháp tiếp thị đó trong mệnh đề SELECT.
Các trường phân đoạn có thể là thuộc tính sản phẩm (ví dụ: offer_id, brand và category) hoặc thuộc tính sự kiện (ví dụ: date và marketing_method).
Các trường phân đoạn hoạt động tương tự như GROUP BY trong SQL. Các trường phân đoạn sẽ phân tách các chỉ số đã chọn, nhóm theo từng phân đoạn trong mệnh đề SELECT.
Dưới đây là một truy vấn mẫu trả về số lượt nhấp mỗi ngày, theo thứ tự giảm dần theo clicks, trong điều kiện được thêm vào của một phạm vi ngày. Chỉ những hàng có ít nhất một chỉ số được yêu cầu khác 0 mới được trả về.
SELECT
date,
clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC
Phản hồi mẫu sau đây cho thấy người bán có 1.546 lượt nhấp vào tất cả sản phẩm, trên tất cả phương pháp tiếp thị, vào ngày 1 tháng 12 năm 2023 và 829 lượt nhấp vào tất cả sản phẩm, trên tất cả phương pháp tiếp thị, vào ngày 2 tháng 12 năm 2023. Người bán không có lượt nhấp nào vào ngày 3 tháng 12 năm 2023, nên không có dữ liệu nào được trả về cho ngày đó.
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}
Giống như báo cáo tuỳ chỉnh trong Merchant Center, bạn có thể chỉ định nhiều phân đoạn trong cùng một truy vấn bằng Merchant Reports API.
Sau đây là một truy vấn mẫu trả về số lượt nhấp cho tất cả sản phẩm trong tài khoản của bạn trong khoảng thời gian 30 ngày, được phân đoạn theo marketing_method và offer_id:
SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'
Kết quả của truy vấn này bao gồm một hàng cho mỗi tổ hợp offer_id và marketing_method, cùng với số lượt nhấp cho tổ hợp đó:
{
"results": [
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12345",
"clicks": "38"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12346",
"clicks": "125"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12346",
"clicks": "23"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12347",
"clicks": "8"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12347",
"clicks": "3"
}
}
]
}
Danh mục và loại sản phẩm
Ngôn ngữ truy vấn của Merchant Center hỗ trợ việc phân đoạn các chỉ số theo hai nhóm thuộc tính mà bạn có thể xác định để sắp xếp kho hàng của mình:
- Cấp danh mục
- Danh mục trong hệ thống phân loại sản phẩm của Google. Google có thể tự động chỉ định danh mục cho sản phẩm của bạn nếu bạn không cung cấp danh mục hoặc tinh chỉnh thêm danh mục mà bạn cung cấp.
- Cấp loại sản phẩm
- Loại sản phẩm mà bạn chỉ định dựa trên cách phân loại của bạn. Không giống như các cấp danh mục, không có tập hợp giá trị được hỗ trợ nào được xác định trước.
Cả thuộc tính danh mục và loại sản phẩm đều được sắp xếp theo hệ phân cấp có nhiều cấp. Quy cách sản phẩm phân tách từng cấp bằng ký tự >, nhưng bạn chọn riêng từng cấp của hệ thống phân cấp trong báo cáo.
Ví dụ: Hãy xem xét một sản phẩm có các cấp loại sản phẩm sau:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
Báo cáo trả về từng cấp trong trường riêng:
| Phân đoạn | Giá trị |
|---|---|
product_type_l1 |
Home & Garden |
product_type_l2 |
Kitchen & Dining |
product_type_l3 |
Kitchen Appliances |
product_type_l4 |
Refrigerators |
Chỉ số về đơn vị tiền tệ và giá
Các chỉ số về giá, chẳng hạn như conversion_value, được biểu thị bằng loại Price. Nếu chỉ số này có sẵn bằng nhiều đơn vị tiền tệ, thì giá trị của mỗi đơn vị tiền tệ sẽ được trả về trong một hàng riêng biệt. Ví dụ: truy vấn sau:
SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'
trả về các kết quả sau:
{
"results": [
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
Nếu bạn yêu cầu cả chỉ số giá và chỉ số không phải giá trong một truy vấn, thì chỉ số giá sẽ được trả về trong các hàng kết quả riêng biệt với chỉ số không phải giá, mỗi hàng kết quả cho một mã tiền tệ. Ví dụ: truy vấn sau:
SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'
trả về phản hồi sau:
{
"results": [
{
"productPerformanceView": {
"conversions": "27",
"conversionValue": {
"amountMicros": "0",
"currencyCode": ""
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
Tất cả các trường bạn chọn đều được trả về trong phản hồi, ngay cả khi giá trị của các trường đó vẫn là giá trị mặc định hoặc bằng 0.
Để biết thêm thông tin về các trường có thể truy vấn, hãy xem bài viết Các trường trong bảng productPerformanceView.