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 được trả về. Bạn phải thêm bộ lọc theo 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à 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": "4,440"
}
}
]
}
Phân đoạn
Bạn có thể sử dụng trường phân khúc để phân đoạn 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 thức tiếp thị và chỉ số mà bạn chỉ định cho phương thức tiếp thị đó trong mệnh đề SELECT.
Các trường phân khúc 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 khúc phân chia các chỉ số đã chọn, nhóm theo từng phân khúc trong mệnh đề SELECT.
Dưới đây là 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 đã thêm về phạm vi ngày. Chỉ những dò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
Nội dung phản hồi mẫu sau đây cho thấy rằng 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ả phương pháp 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ả 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, vì vậy, không có kết quả 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"
}
}
]
}
Tương tự như báo cáo tuỳ chỉnh trong Merchant Center, bạn có thể chỉ định nhiều phân khúc trong cùng một truy vấn bằng Merchant Reports API.
Dưới đây là 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 tổ hợp offer_id và marketing_method, 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 Merchant Center hỗ trợ 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ảng không quảng cáo:
- Cấp danh mục
- Danh mục trong 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 hoặc tinh chỉnh thêm danh mục mà bạn đã cung cấp.
- Cấp loại sản phẩm
- Các loại sản phẩm mà bạn chỉ định dựa trên cách phân loại. Không giống như các cấp danh mục, không có tập hợp giá trị được hỗ trợ đượ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. Thông số kỹ thuật của 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ệ 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ề đơn vị tiền tệ và giá
Các chỉ số giá, chẳng hạn như conversion_value, được biểu thị bằng loại Price. Nếu chỉ số có sẵn bằng nhiều đơn vị tiền tệ, thì giá trị của từng đơ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'
sẽ 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 mã đơn vị tiền tệ sẽ có một hàng kết quả. 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 sẽ đượ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.