Performance reports

API Merchant cung cấp các báo cáo hiệu suất, ví dụ: ProductPerformanceView. 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 một bộ lọc trong phạm vi ngày để truy vấn dịch vụ Báo cáo cho 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, có tổng số lượt nhấp trong phạm vi ngày được chỉ định:

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-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ề một lỗi.

Câu trả lờ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ả các sản phẩm, trên mọi phương thức tiếp thị trong khoảng thời gian từ ngày 1 tháng 12 năm 2020 đến ngày 21 tháng 12 năm 2020.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

Phân đoạn

Bạn có thể sử dụng MCQL để truy vấn các trường phân đoạn. Các trường phân đoạn có thể là thuộc tính sản phẩm (ví dụ: offerId, brand và category) hoặc thuộc tính sự kiện (ví dụ: date và marketingMethod).

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 các chỉ số đã chọn, nhóm theo từng phân đoạn 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 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 ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

Câu trả lờ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 mọi phương thức tiếp thị) vào ngày 1 tháng 12 năm 2020 và 829 lượt nhấp vào tất cả cá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 2020. Người bán không có lượt nhấp nào vào ngày 3 tháng 12 năm 2020, vì vậy, ngày đó sẽ không trả về kết quả nào.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}