GET Get Video Performances
Get Video Performances Creator Scope bắt buộc: creator.video.write Đây hiện là API chỉ dành cho creator tại US. Và nó dùng để lấy các chỉ số video TikTok E-commerce (bao gồm anchor_display_rate, ctr, orders, items_sold, gmv) để phân tích. Version 202403
GET/analytics/202403/videos/performances
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của creator từ Get Access Token, khi user_type = 1. Làm theo hướng dẫn này để lấy access_token của creator. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng 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 yêu cầu 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 yêu cầu API. Nhà phát triển có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| video_ids Required | string | Tập hợp các video ID để lấy các chỉ số e-commerce. Người gọi phải đảm bảo tất cả video ID có cùng author ID. Giới hạn kích thước tập hợp là 100. Dùng "," để phân tách các phần tử mảng khi gửi trong query. |
| start_time_ge Required | int | Ngày bắt đầu cho các chỉ số, được đặt với độ trễ một ngày so với hôm nay do độ trễ trong pipeline dữ liệu. Tham số start_time phải nằm trong vòng 180 ngày gần nhất tính từ ngày hiện tại. Chỉ giá trị ngày được xử lý, giá trị giờ/phút/giây sẽ bị bỏ qua. Ví dụ, nếu giá trị start_time là: 1703507696 ("26-12-2023 04:34:56"), dịch vụ backend sẽ chỉ xem xét phần "26-12-2023" khi truy vấn vì mặc định, trong phân tích dữ liệu offline, không có cấp độ dữ liệu giờ/phút/giây. |
| end_time_le Required | int | Ngày kết thúc cho các chỉ số, được đặt với độ trễ một ngày so với hôm nay do độ trễ trong pipeline dữ liệu. Chỉ giá trị ngày được xử lý, giá trị giờ/phút/giây sẽ bị bỏ qua. |
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 phản hồi API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong thông báo. |
| request_id | string | Log yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | Trống. Không có mã lỗi logic nghiệp vụ. |
Is this content helpful?Helpful
Not Helpful
PreviousNext