GET Lấy danh sách hiệu suất sản phẩm trong video của shop
Lấy danh sách hiệu suất sản phẩm trong video của shop Shop Scope yêu cầu: data.shop_analytics.public.read Trả về các chỉ số hiệu suất cho danh sách sản phẩm được quảng bá trong một video nhất định. Phiên bản 202509
GET/analytics/202509/shop_videos/{video_id}/products/performance
Request
Path
| Properties | Type | Description |
|---|---|---|
| video_id Required | string | ID của video |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi request API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được dùng trên tất cả các request API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| end_date_lt Required | string | Ngày kết thúc (định dạng ISO 8601 YYYY-MM-DD) theo múi giờ đăng ký của shop. Trong tên tham số, "lt" nghĩa là "less than" (không bao gồm) |
| page_size | int | Số sản phẩm trên mỗi trang.Giá trị tối đa: 100Giá trị mặc định: 10 |
| sort_field | string | Trường để sắp xếp.Các giá trị khả dụng: gmv, units_sold, daily_avg_buyersGiá trị mặc định: gmv |
| sort_order | string | Hướng sắp xếp.Các giá trị khả dụng: ASC, DESCGiá trị mặc định: DESC* ASC: tăng dần* DESC: giảm dần |
| currency | string | Tiền tệ.Các giá trị khả dụng: USD, LOCALGiá trị mặc định: LOCAL* USD: đô la Mỹ* LOCAL: tiền tệ địa phương nơi shop tọa lạc |
| page_token | string | Page token, cho biết vị trí hiện tại. Dùng để yêu cầu dữ liệu trang tiếp theo.Để trống trường này cho lần truy vấn đầu tiên. |
| start_date_ge Required | string | Ngày bắt đầu (định dạng ISO 8601 YYYY-MM-DD) theo múi giờ đăng ký của shop. Trong tên tham số, "ge" nghĩa là "greater than or equal to" (bao gồm) |
| shop_cipher Required | string | Dùng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong response API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log của request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
Xem các mã lỗi thường gặp
| Code | Message | | --- | --- | | 28001022 | invalid request params; detail: start time or end time is invalid. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext