POST Diagnose and Optimize Product
Chẩn đoán và Tối ưu Sản phẩm Shop Scope yêu cầu: serller.product.optimize Chẩn đoán sản phẩm để thu thập thông tin giúp bạn cải thiện nội dung sản phẩm, nâng cao khả năng hiển thị sản phẩm và sự tin tưởng của khách hàng. Thông tin trả về bao gồm:
- Thông tin chất lượng listing (chỉ khả dụng cho thị trường Hoa Kỳ).
- Các vấn đề với chi tiết sản phẩm hiện tại và các khuyến nghị tổng thể
- Các gợi ý tối ưu được tạo tự động nhắm đến các trường sản phẩm cụ thể, bao gồm tiêu đề, mô tả và hình ảnh. API này cho phép bạn chẩn đoán cả sản phẩm đang hoạt động (status: ACTIVATE) và sản phẩm hoàn toàn mới chưa được đăng bán trên TikTok Shop.
- Để chẩn đoán một sản phẩm đang hoạt động, hãy cung cấp product_id và category_id và để trống tất cả các chi tiết sản phẩm khác.
- Để chẩn đoán một sản phẩm hoàn toàn mới chưa được đăng bán trên TikTok Shop, hãy bỏ qua product_id và cung cấp các chi tiết sản phẩm khi cần thiết.
- Để chẩn đoán một sản phẩm tương tự với sản phẩm hiện có, hãy cung cấp product_id và category_id, cùng với bất kỳ chi tiết mới nào. Việc chẩn đoán sẽ kết hợp thông tin của sản phẩm hiện có với các chi tiết mới mà bạn cung cấp. Ví dụ, nếu bạn cung cấp một tiêu đề mới, việc chẩn đoán sẽ sử dụng tiêu đề mới thay vì tiêu đề hiện có trong khi vẫn giữ các giá trị khác từ product ID. Lưu ý:
- Để chẩn đoán nhiều sản phẩm đang hoạt động, hãy sử dụng Product Information Issue Diagnosis API
.
- API này chỉ tập trung vào việc tối ưu khả năng hiển thị sản phẩm và không đánh giá liệu sản phẩm của bạn có đáp ứng các yêu cầu đăng bán hay không. Các vấn đề chất lượng được xác định bởi API này không chặn sản phẩm của bạn khỏi việc được đăng bán. Để xác minh các yêu cầu đăng bán, hãy sử dụng Check Product Listing API
. Version 202411
POST/product/202411/products/diagnose_optimize
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
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 các yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận dạng người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể sử dụng để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Sử 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ề phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description | |||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| product_id | string | Product ID của một sản phẩm hiện có trong TikTok Shop.- Bỏ qua giá trị này nếu bạn đang chẩn đoán một sản phẩm hoàn toàn mới chưa được đăng bán trên TikTok Shop.- Cung cấp ID này nếu sản phẩm tương tự với một sản phẩm hiện có, và bạn muốn việc chẩn đoán xem xét cả chi tiết của sản phẩm hiện có và thông tin mới trong yêu cầu này. | |||||||||||||||||||||||||||||||||
| category_id Required | string | ID của danh mục của sản phẩm này. Nó phải là một danh mục lá tương ứng với loại cây danh mục được chỉ định trong thuộc tính category_version. Sử dụng Get Categories API để tìm hiểu xem một danh mục có phải là danh mục lá trong một category_version cụ thể hay không.Lưu ý:- Đối với thị trường Hoa Kỳ, hãy tham khảo TikTok Shop Restricted Products Policy để biết thông tin về các hạn chế danh mục sản phẩm.- Đối với thị trường Indonesia, để đăng bán một sản phẩm trên cả TikTok Shop và Tokopedia, bạn chỉ được sử dụng các danh mục có sẵn trên cả hai nền tảng. | |||||||||||||||||||||||||||||||||
| description | string | Mô tả sản phẩm ở định dạng HTML.Lưu ý:- Nội dung phải tuân thủ cú pháp HTML. Tất cả các thẻ HTML đều được chấp nhận nhưng để tối ưu hiển thị trên trang chi tiết sản phẩm TikTok Shop, hệ thống sẽ tự động chuyển đổi một số thẻ nhất định sang các định dạng thay thế, chẳng hạn như hiển thị thẻ dưới dạng hình ảnh.- Độ dài tối đa: 10,000 ký tự.- Hình ảnh phải sử dụng URL hình ảnh của TikTok Shop, không vượt quá 4000px, và bao gồm các thuộc tính src, width và height.Khuyến nghị:- Nếu bạn đang đồng bộ một mô tả có sẵn từ một nền tảng khác, hãy bao gồm toàn bộ mô tả nguồn HTML tại đây.- Cung cấp một mô tả chi tiết, lý tưởng là trên 300 ký tự.- Bao gồm 3-5 điểm bán hàng chính, mỗi điểm dưới 250 ký tự, kèm theo hình ảnh hỗ trợ.- Sử dụng kích thước 1600x1600 px cho hình ảnh.
Example CurlGoNode.jsJavaEnable word wrap Response Parameters
Example JSONEnable word wrap Error Code View common error codes | Code | Message | | --- | --- | | Empty. No business logic error codes. | Nội dung này có hữu ích không?Hữu ích Không hữu ích PreviousNext |