Performance reports

Merchant API 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 chỉ số (ví dụ: clicks và impressions) mà bạn muốn được 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 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 với 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 *) trả về một lỗi.

Phản hồi mẫu sau đây cho thấy rằng người bán đã có tổng cộng 4.440 số 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ị, từ ngày 1 tháng 12, năm 2020 và ngày 21/12/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 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 sẽ tách 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 sẽ được trả về.

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

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 mọi phương thức tiếp thị, vào ngày 1 tháng 12 năm 2020 và ngày 829 số 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 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, nên sẽ không có lượt nhấp nào được trả về cho ngày đó.

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