v2.account_health.get_shop_performance
GET /api/v2/account_health/get_shop_performance
Các chỉ số dữ liệu về hiệu suất của gian hàng.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/account_health/get_shop_performance
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | ID đối tác được cấp sau khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token dùng để truy cập API, xác định quyền của bạn đối với API. Có thể dùng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của Shopee cho một gian hàng. Tham số bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Chữ ký được tạo từ partner_id, đường dẫn api, timestamp, access_token, shop_id và partner_key qua thuật toán băm HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Không có Tham số Yêu cầu.
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Cho biết loại lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. | |
| request_id | string | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. | |
| response | object | ||
| overall_performance | object | ||
| rating | int32 | Hiệu suất tổng thể: Kém = 1 Cần cải thiện = 2 Tốt = 3 Xuất sắc = 4 | |
| fulfillment_failed | int32 | Số chỉ số không đạt mục tiêu trong loại Hiệu suất Thực hiện Đơn hàng. | |
| listing_failed | int32 | Số chỉ số không đạt mục tiêu trong loại Hiệu suất Sản phẩm. | |
| custom_service_failed | int32 | Số chỉ số không đạt mục tiêu trong loại Hiệu suất Dịch vụ Khách hàng. | |
| metric_list | object[] | ||
| metric_type | int32 | Loại chỉ số: Hiệu suất Thực hiện Đơn hàng = 1 Hiệu suất Sản phẩm = 2 Hiệu suất Dịch vụ Khách hàng = 3 | |
| metric_id | int64 | ID của chỉ số. Nếu metric_id < 0, đây không phải chỉ số thực sự mà là nhóm chỉ số. Chat chưa phản hồi = -1 Tỷ lệ Giao hàng Trễ (Tất cả kênh) = 1 Tỷ lệ Không hoàn thành Đơn hàng (Tất cả kênh) = 3 Thời gian Chuẩn bị = 4 Tỷ lệ Phản hồi Chat = 11 % Sản phẩm Đặt trước = 12 Số ngày Vi phạm Sản phẩm Đặt trước = 15 Thời gian Phản hồi = 21 Đánh giá Gian hàng = 22 Số Chat chưa phản hồi = 23 Tỷ lệ Bàn giao Nhanh = 25 Tỷ lệ Thất bại Lấy hàng Đúng hạn = 27 Giá trị Vi phạm Tỷ lệ Thất bại Lấy hàng = 28 Thời gian Phản hồi Trung bình = 29 Tỷ lệ Hủy (Tất cả kênh) = 42 Tỷ lệ Trả hàng/Hoàn tiền (Tất cả kênh) = 43 Vi phạm Sản phẩm Nghiêm trọng = 52 Vi phạm Sản phẩm Khác = 53 Sản phẩm Bị cấm = 54 Hàng giả/Vi phạm SHTT = 55 Sản phẩm Spam = 56 Tỷ lệ Giao hàng Trễ (NDD) = 85 Tỷ lệ Không hoàn thành (NDD) = 88 Tỷ lệ Hủy (NDD) = 91 Tỷ lệ Trả hàng/Hoàn tiền (NDD) = 92 Sự hài lòng của Khách hàng = 95 % Sản phẩm SDD = 96 % Sản phẩm NDD = 97 Tỷ lệ Bàn giao Nhanh - SLS = 2001 Tỷ lệ Bàn giao Nhanh - FBS = 2002 Tỷ lệ Bàn giao Nhanh - 3PF = 2003 Sản phẩm Kém Chất lượng = 2011 % Sản phẩm HD = 2030 % Sản phẩm HD Bật Miễn phí Vận chuyển = 2031 Giao hàng Thứ Bảy = 2032 Thời gian Chuẩn bị PS = 2033 | |
| parent_metric_id | int64 | ID của chỉ số cha. | |
| metric_name | string | Tên mặc định của chỉ số. | |
| current_period | float | Hiệu suất của chỉ số trong kỳ hiện tại. | |
| last_period | float | Hiệu suất của chỉ số trong kỳ trước. | |
| unit | int32 | Đơn vị của chỉ số: Số = 1 Phần trăm = 2 Giây = 3 Ngày = 4 Giờ = 5 | |
| target | object | ||
| value | float | Giá trị mục tiêu. | |
| comparator | string | Toán tử so sánh của mục tiêu: <, <=, >, >=, = | |
| exemption_end_date | string | (Chỉ dành cho người bán TW trong danh sách trắng) Giá trị exemption_end_date sẽ không rỗng nếu TẤT CẢ điều kiện được đáp ứng: - Gian hàng có trong "Danh sách Trắng Gian hàng POL" - Trong "Thời gian Miễn trừ" - metric_id là 12 (% Sản phẩm Đặt trước) hoặc 15 (Số ngày Vi phạm Sản phẩm Đặt trước) |