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 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.
Sau đâ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 được 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 đã nhận được tổng cộng 4.440 lượt nhấp cho tất cả sản phẩm và tất cả phương thức tiếp thị trong khoảng thời gian 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 các trường phân đoạn để phân đoạn trong báo cáo hiệu suất.
Ví dụ: việc 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 đ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ư một GROUP BY trong SQL. Các trường phân đoạn chia 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 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ả 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 vào 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, 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"
}
}
]
}
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.
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'
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 2 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 nào 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. 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à loại sản phẩm đều được sắp xếp theo một hệ 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 riêng từng cấp của hệ 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ố có 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 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ố về giá và chỉ số không về giá trong một truy vấn, thì chỉ số về giá sẽ được trả về trong các hàng kết quả riêng biệt so với chỉ số không 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 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.