API báo cáo
API Báo cáo cho phép người bán tương tác với dữ liệu hiệu suất của họ có lập trình thông qua Ngôn ngữ truy vấn của Merchant Center. Điều này tương tự như khả năng tạo báo cáo tuỳ chỉnh ngay trong Merchant Center. API Báo cáo có những lợi ích sau:
- Cho phép những người bán lớn nhập dữ liệu hiệu suất của trang thông tin sản phẩm vào hệ thống báo cáo nội bộ hoặc bên thứ ba.
- Cho phép người dùng, đối tác bên thứ ba và đơn vị tập hợp quản lý tài khoản Người bán Báo cáo quyền truy cập vào tài khoản trung tâm.
Người dùng API có thể chỉ định dữ liệu hiệu suất mà họ muốn truy xuất trong Tìm kiếm phản hồi cuộc gọi, chẳng hạn như:
- Chỉ số được trả về (ví dụ: Số lượt nhấp, Số lượt hiển thị)
- Những phương diện để phân đoạn dữ liệu (ví dụ: OfferId, Ngày)
- Các điều kiện cần được đáp ứng (ví dụ: Số lượt nhấp > 100)
Ngôn ngữ truy vấn của API Báo cáo có thể truy vấn Content API for Shopping cho
chỉ số hiệu suất (số lượt nhấp, số lượt hiển thị), có thể được phân đoạn theo
phương diện (các thuộc tính sự kiện được báo cáo như ngày và chương trình, cũng như sản phẩm
như thương hiệu, danh mục, v.v.) bằng cách sử dụng phương thức Search trên
Dịch vụ Reports.
Kết quả của một truy vấn đến dịch vụ Reports là danh sách ReportRow
thực thể, trong đó mỗi ReportRow đại diện cho giá trị của các chỉ số được yêu cầu
cho các phân đoạn mà bạn đã chỉ định trong truy vấn của mình. Nếu không có phân đoạn nào được chỉ định, một
được trả về cùng với các chỉ số được tổng hợp trên tất cả các phân đoạn. Ngược lại, nếu có
được yêu cầu cùng với chỉ số, sau đó phản hồi hiển thị một hàng cho
từng bộ dữ liệu phân đoạn riêng biệt. Bạn có thể chọn nhiều phân đoạn và
nhiều chỉ số trong một truy vấn.
Truy vấn chỉ số
Bạn có thể truy vấn các chỉ số (Lượt nhấp, Lượt hiển thị, CTR, v.v.) mà mình muốn bị trả lại. Bạn phải thêm một bộ lọc trên phạm vi ngày để truy vấn Báo cáo . Truy vấn mẫu bên dưới trả về một hàng duy nhất: số tiền tổng hợp nhấp chuột trong điều kiện bổ sung của một phạm vi ngày.
SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';
Phản hồi mẫu
Phản hồi về mã JSON mẫu bên dưới cho thấy cách người bán này đã nhận được 4.440 lượt nhấp được tổng hợp trên tất cả sản phẩm của họ trên tất cả các điểm đến giữa ngày 01/12/2020 và ngày 21/12/2020.
{"results": [
{
"metrics": {
"clicks": "4,440"
}
}
]}
Truy vấn phân khúc
Cùng với chỉ số, bạn cũng có thể truy vấn các phân đoạn, đây có thể là thuộc tính của
sản phẩm (offer_id, brand, category, v.v.) hoặc thuộc tính của sản phẩm được báo cáo
sự kiện (date, program). Sự kiện được báo cáo là một lượt hiển thị hoặc lượt nhấp cho một
của Google.
Các phân đoạn hoạt động tương tự như GROUP BY trong SQL. Các phân đoạn đã chọn
chỉ số, được nhóm theo từng phân đoạn trong mệnh đề SELECT. Truy vấn mẫu bên dưới
trả về số lượt nhấp mỗi ngày, được sắp xếp theo số lượt nhấp giảm dần 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
bị trả lại.
SELECT
segments.date,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;
Phản hồi mẫu
Phản hồi mã JSON mẫu bên dưới cho thấy cách người bán này đã nhận được 1.546 lượt nhấp trên tất cả sản phẩm của họ tại mọi điểm đến vào ngày 1 tháng 12 năm 2020 và 829 lượt nhấp trên tất cả các sản phẩm của họ trên mọi đích đến của Ngày 2 tháng 12 năm 2020. Sẽ không có đối tượng nào được trả lại cho ngày 3 tháng 12 năm 2020 vì người bán không có nhấp chuột vào ngày đó.
{
"results": [
{
"segments": {
"date": {
"year": 2020,
"month": 12,
"day": 1
}
},
"metrics": {
"clicks": "1546"
}
},
{
"segments": {
"date": {
"year": 2020,
"month": 12,
"day": 2
}
},
"metrics": {
"clicks": "829"
}
}
]}