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 hệ thống trả về. Bạn phải thêm bộ lọc vào 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 đã 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 hệ thống 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ả cá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 khúc để phân khúc trong báo cáo hiệu suất.
Ví dụ: truy vấn marketing_method sẽ trả về 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 chia 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 phạm vi ngày đã thêm. Hệ thống chỉ trả về những hàng có ít nhất một chỉ số được yêu cầu khác 0.
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 trên tất cả sản phẩm, trên tất cả các phương thức tiếp thị vào ngày 1 tháng 12 năm 2023 và 829 lượt nhấp trên tất cả sản phẩm, trên tất cả các phương thức 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, vì vậy, hệ thống không trả về dữ liệu 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.
Dưới đâ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'
Phản hồi từ truy vấn này bao gồm một hàng cho mỗi kiểu kết hợp offer_id và marketing_method, với số lượt nhấp cho kiểu kế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 Merchant Center hỗ trợ phân đoạn 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ấp danh mục
- Danh mục từ cây 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 nào hoặc tinh chỉnh thêm danh mục đã 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 sản phẩm 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ợ định sẵn.
Cả thuộc tính danh mục và thuộc tính loại sản phẩm đều được sắp xếp theo hệ thống phân cấp có nhiều cấp. Thông số kỹ thuật sản phẩm phân tách từng
cấp bằng ký tự >, nhưng bạn chọn từng cấp của hệ thống phân cấp
riêng biệt 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ề 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ố có sẵn ở nhiều đơn vị tiền tệ, thì giá trị cho mỗi đơn vị tiền tệ sẽ được trả về trong một hàng riêng. Ví dụ: truy vấn sau:
SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'
trả về 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ố về giá và chỉ số không phải về giá trong một truy vấn, thì các chỉ số về giá sẽ được trả về trong các hàng kết quả riêng biệt so với các chỉ số không phải về giá, một hàng kết quả cho mỗi mã đơn vị 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 mà 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ó sẵn cho truy vấn, hãy xem Các trường trong bảng productPerformanceView.